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# 1. 0. 0 INTRODUCTION. 


# 1 . 0 . 0 


THIS MANUAL DESCRIBES ONE OF THE X8 (CROSS EIGHT) SERIES OF MICRO¬ 
PROCESSOR CROSS-ASSEMBLERS SIERRA DIGITAL SYSTEMS HAS DEVELOPED FOR 
PDP8 USERS. THE X8 SERIES WILL HANDLE ALL OF THE POPULAR MICRO¬ 
PROCESSORS WITHIN A UNIVERSAL ASSEMBLER FORMAT. THIS COMMON BASE 
OF ASSEMBLER DIRECTIVES AND TECHNIQUES IS A SELECTED COMBINATION OF 
DESIRABLE FEATURES OBSERVED IN A SURVEY OF MANY EXISTING MINI¬ 
COMPUTER AND MICROPROCESSOR ASSEMBLERS. THE INSTRUCTION MNEMONICS 
AND ASSOCIATED SYNTAX OF EACH PARTICULAR MICROPROCESSOR ARE 
RETAINED UNCHANGED. 

THIS MANUAL DESCRIBES THE USAGE OF ONE OF THE MICROPROCESSOR CROSS- 
ASSEMBLERS FROM THE SIERRA DIGITAL X8 SERIES. IN ORDER TO SIMPLIFY 
THE LEARNING PROCESS FOR INDIVIDUALS USING MORE THAN ONE CROSS- 
ASSEMBLER FROM THE SERIES, THIS MANUAL HAS BEEN DIVIDED INTO TWO 
MAJOR PARTS. SECTIONS 1 THROUGH 11 DOCUMENT THE UNIVERSAL ASSEMBLER 
FORMAT AS IT APPLIES TO ALL CROSS-ASSEMBLERS IN THE SERIES. THESE 
SECTIONS WILL BE IDENTICAL IN EVERY CROSS-ASSEMBLER MANUAL. 
SECTION 12 PRESENTS INFORMATION ON APPLICATION OF THE UNIVERSAL 
ASSEMBLER FORMAT TO THE SPECIFIC MICROPROCESSOR CROSS-ASSEMBLER. 
SECTION 13 PRESENTS A SUMMARY OF THE MNEMONIC INSTRUCTION CODES 
ASSIGNED BY THE MICROPROCESSOR VENDOR AND RECONI ZED BY THE CROSS- 
ASSEMBLER. NO ATTEMPT HAS BEEN MADE TO DESCRIBE THE OPERATION OF 
THE MICROPROCESSOR ITSELF. SUCH INFORMATION MUST BE OBTAINED FROM 
THE MICROPROCESSOR VENDOR OR OTHER SOURCES. SECTION 14, THE APPEN¬ 
DICES, CONTAINS SUMMARY TABLES FOR QUICK REFERENCE ONCE THE USER 
GAINS EXPERTISE IN USING THE CROSS-ASSEMBLER. 

WE AT SIERRA DIGITAL LOOK FORWARD TO DEVELOPING MORE ASSEMBLERS IN 
OUR X8 SERIES TO PROVIDE YOU, THE USER, WITH THE MEANS OF 
PIONEERING THE NEW WORLD OF MICROPROCESSORS. 


# 2. 0. 0 OPERATION. 


SIERRA DIGITAL'S CROSS-ASSEMBLER IS AN 8K, TWO PASS ASSEMBLER WHICH 
RUNS UNDER THE OS/8 OPERATING SYSTEM. THE CROSS-ASSEMBLER IS CODED 
IN PDP/8 ASSEMBLY LANGUAGE (PALS) TO GIVE FAST EXECUTION TIMES. 
(LESS THAN 30 SECONDS FOR A NORMAL 4K BYTE PROGRAM IS TYPICAL). 

PASS 1 READS THE INPUT FILES AND SETS UP THE SYMBOL TABLES. PASS 2 
THEN GENERATES THE OUTPUT FILE IN THE BINARY (OBJECT) FORMAT OF THE 
PARTICULAR MICROPROCESSOR. THE OUTPUT FILE CAN BE CHANGED TO BNPF 
FORMAT THROUGH USE OF THE /B RUN-TIME OPTION. 

A THIRD ASSEMBLY PASS IS DONE WHEN A LISTING OUTPUT FILE IS SPECI¬ 
FIED. WHEN NO BINARY FILE IS SPECIFIED, THE ASSEMBLER GOES DIRECTLY 
TO THE PASS 3 LISTING. 





#2. O. 0 


THE CROSS-ASSEMBLER IS NOT RESTARTABLE. IF AN ATTEMPT IS MADE TO 
RESTART THE ASSEMBLER WITH A .ST COMMAND, THE KEYBOARD MONITOR 
RETURNS A "NO!!" . 

TYPING CTRL/C WILL HALT ASSEMBLY AND CAUSE AN IMMEDIATE EXIT TO THE 
KEYBOARD MONITOR. 

TYPING CTRL/O AT THE KEYBOARD DURING ASSEMBLY WILL SUPPRESS THE 
LISTING OF ERROR MESSAGES TO THE CONSOLE DURING PASSES 1 AND 2. THE 
OUTPUT FILE WILL STILL SHOW THE ERROR MESSAGES IMMEDIATELY BEFORE 
THE LINE THAT IS IN ERROR. 


# 2. 1.0 LOADING AND SAVING THE CROSS-ASSEMBLER. 


THE CROSS-ASSEMLER IS PROVIDED IN BINARY FORMAT ON PAPER TAPE OR IN 
BOTH BINARY AND IMAGE FORMATS ON FILE-STRUCTURED MEDIA. 

TO LOAD THE ASSEMBLER FROM PAPER TAPE AND SAVE IT, PLACE THE TAPE 
IN THE READER AND CALL THE ABSOLUTE LOADER: 

. R ABSLDR 
*PTR:$ 

. SAVE SYS: XNAME 

FROM FILE STRUCTURED MEDIA, THE IMAGE FORMAT PROGRAM MAY BE COPIED 
DIRECTLY TO THE SYSTEM DEVICE OR THE BINARY FORMAT FILE MAY BE 
LOADED WITH THE ABSOLUTE LOADER. MODIFICATIONS TO THE IMAGE FILE, 
SUCH AS INVERTING THE SENSE OF A RUN-TIME OPTION, MAY BE 
IMPLEMENTED ACCORDING TO THE NOTES IN SECTION # 11.0.0 . 


# 2. 2. 0 CALLING SEQUENCE. 


ONCE LOADED AND SAVED, THE CROSS-ASSEMBLER IS CALLED FROM THE 
SYSTEM DEVICE BY TYPING: 

. R XNAME 

THE ASSEMBLER CALLS THE COMMAND DECODER WHICH RESPONDS WITH AN 
ASTERISK IN THE LEFT HAND MARGIN. THE USER MAY THEN TYPE IN THE 
INPUT AND OUTPUT FILE SPECIFICATIONS AND RUN-TIME OPTIONS: 

*DEV:BIN,DEV:LISTCDEV: INI, . . . DEV: IN9/0PT 

THE FIRST OUTPUT FILE IS THE MICROPROCESSOR BINARY OBJECT FILE 
WRITTEN IN THE FORMAT SPECIFIED BY THE VENDOR OF THE PARTICULAR 
MICROPROCESSOR. (SEE SECTION 12. 0. O FOR THE FORMAT SPECIFICATIONS). 





# 2 . 2 . 0 


THE SECOND OUTPUT FILE IS THE OPTIONAL LISTING. WHEN ONLY THE FIRST 
OUTPUT FILE IS SPECIFIED, THE ASSEMBLER ASSUMES THAT IT WILL BE THE 
BINARY OUTPUT FILE AND THE LISTING IS OMITTED. 

THE FOLLOWING EXAMPLE SPECIFIES FILE "INI" TO BE READ FROM DECTAPE 
0 AND THE BINARY (OBJECT) FILE TO BE OUTPUT TO THE PAPER TAPE PUNCH 
WITH NO LISTING: 

. R XNAME 
*PTP:CDTAO:INI 

THIS EXAMPLE SPECIFIES 2 FILES AS THE SOURCE INPUT (FROM THE DSK: 
DEVICE) WITH ONLY THE PASS 3 LISTING BEING OUTPUT TO THE LINE 
PRINTER: 

. R XNAME 
*, LPT: <IN1, IN2 

UP TO NINE INPUT FILES CAN BE SPECIFIED AS ONE PROGRAM WHERE THE 
LAST FILE IS TERMINATED WITH AN . END STATEMENT. 

# 2. 3. 0 INPUT/OUTPUT FILE EXTENSIONS. 


IF THE EXTENSION TO AN INPUT FILE NAME IS OMITTED, THE ASSEMBLER 
ASSUMES THE . MS EXTENSION. IF THERE IS NO FILE WITH THAT NAME AND 
AN . MS EXTENSION, THE ASSEMBLER ASSUMES THE NULL EXTENSION. UNLESS 
EXTENSIONS ARE SPECIFIED, THE . MB AND . LS EXTENSIONS ARE ADDED TO 
THE OUTPUT BINARY AND LISTING FILES. 


. MB - MICROPROCESSOR BINARY OUTPUT FILE EXTENSION. 

. LS - OUTPUT LISTING FILE EXTENSION. 

. MS - MICROPROCESSOR SOURCE FILE EXTENSION. 


# 2. 4. 0 RUN-TIME OPTIONS. 


TABLE #1 DESCRIBES THE OPTIONS WHICH MAY BE SPECIFED AT RUN-TIME 
IN THE INPUT LINE TO THE COMMAND DECODER. 

IF ONE OR MORE OF THESE OPTIONS IS CONTINUALLY CALLED, THE USER 
SHOULD CONSIDER MODIFYING THE ASSEMBLER TO INVERT THE SENSE OF THE 
OPTION. THE MODIFICATION NOTES IN SECTION #11.0.0 EXPLAIN HOW THIS 
MAY BE DONE. FOR EXAMPLE, A USER WHO PREFERS TO OUTPUT FILES IN 
BNPF FORMAT RATHER THAN BINARY CAN INVERT THE SENSE OF THE /B 
OPTION. THEN THE BINARY FILES ARE NORMALLY WRITTEN IN BNPF FORMAT. 
USE OF THE /B OPTION THEN CAUSES THE OUTPUT FILE TO BE WRITTEN IN 
THE STANDARD MICROPROCESSOR BINARY CODE. SPACE IS PROVIDED IN 
TABLE #1 TO CHECK OFF WHICH OPTIONS HAVE BEEN INVERTED FOR YOUR 
REFERENCE. 





TABLE #1. RUN-TIME OPTIONS. 


#2. 4. 0 


OPTION MEANING INVERT? 

/B THE BINARY OUTPUT FILE IS WRITTEN IN BNPF FORMAT. - 

INSTEAD OF IN THE MICROPROCESSOR VENDOR'S STANDARD 
BINARY FORMAT. 

FOR THE BNPF FORMAT, THE BINARY OUTPUT IS CONVERTED 
TO ASCII TEXT WHERE 

"B" INDICATES THE BEGINNNING OF A BYTE, 

"F" INDICATES THE END OF A BYTE, 

"P" INDICATES A 1 BIT AND' 

"N" INDICATES A 0 BIT. 

FOUR BYTES , SEPARATED BY SPACES, ARE WRITTEN PER 
LINE. THE ADDRESS OF THE FIRST BYTE IS GIVEN IN 
SIX DIGIT OCTAL AT THE BEINNING OF THE LINE. 

LEADING ZEROES IN THE ADDRESS ARE CONVERTED TO 
SPACES. EACH LINE IS PRECEDED BY 2 SPACES. LEADER 
CONSISTS OF 100 NULL CHARACTERS WITH 20 RUBOUTS 
IMMEDIATELY PRECEEDING AND FOLLOWING THE ASCII 
TEXT. 

EXAMPLE: THE FOLLOWING CODE IS SHOWN REWRITTEN IN 

BNPF FORMAT. 

. ORG 100 

. BYTE 27, C7, AF, D7, FF, 72, 0, DO 

100 BNNPNNPPPF BPPNNNPPPF BPNPNPPPPF BPPNPNPPPF 
104 BPPPPPPPPF BNPPPNNPNF BNNNNNNNNF BPPNPNNNNF 


/E INHIBIT ERROR MESSAGES TO THE CONSOLE. 

NORMALLY ERROR MESSAGES ARE OUTPUT TO THE CONSOLE 
DURING ASSEMBLY PASSES 1 AND 2. SINCE ERROR MESS¬ 
AGES ARE INCLUDED IN THE LISTING, USERS WITH SLOW 
CONSOLE DEVICES SUCH AS TTY'S CAN SPEED ASSEMBLY 
TIME WITH THIS OPTION. 

ALSO, IF THE BINARY FILE IS TO BE OUTPUT TO THE 
CONSOLE DEVICE, THE ERROR MESSAGES AND BINARY 
OUTPUT LINES WILL BE INTERMIXED. THE /E OPTION WILL 
INHIBIT ALL BUT FATAL ERROR MESSAGES SO THAT ONLY 
THE BINARY FILE IS OUTPUT. 







TABLE #1. RUN-TIME OPTIONS. (CONT. ) #2. 4. 0 

*#####*##*#*****#*#*#**•«■ 

OPTION MEANING INVERT? 

/H INHIBIT HEADINGS AND PAGINATION. - 

NORMALLY, THE ASSEMBLER AUTOMATICALLY PAGES THE 
OUTPUT, ADDING A HEADER TO THE TOP OF THE PAGE. USE 
OF THE /H OPTION WILL ELIMINATE THE HEADING AND THE 
PAGINATION. 

/J LIST UNASSEMBLED STATEMENTS AND CONDITIONAL - 

ASSEMBLY PSEUDO-OPS. 

STATEMENTS WHICH DO NOT GET ASSEMBLED DUE TO 
CONDITIONAL ASSEMBLY PSEUDO-OPS ARE NORMALLY NOT 
LISTED. NEITHER ARE THE CONDITIONAL PSEUDO-OPS 
THEMSELVES. USE OF THE /.J OPTION WILL ADD THESE 
STATEMENTS TO THE LISTING. 

/K EXPAND SYMBOL TABLE STORAGE INTO EXTRA CORE. - 

NORMALLY MOST OF FIELD 1 IS USED FOR BOTH LOCAL AND 
NORMAL USER SYMBOL STORAGE. USE OF THE /K OPTIONS 
EXPANDS CORE USAGE TO 12l< WHERE THE LOCAL SYMBOL 
TABLE RESIDES IN FIELD 2 AND THE REGULAR SYMBOL 
TABLE RESIDES IN FIELD 1. 

/L OUTPUT LEADER IN BINARY FILE FOR . ORG STATEMENTS - 

THIS OPTION MAY BE USED TO PHYSICALLY SEPARATE 
DISCONTINUOUS SECTIONS OF THE BINARY OUTPUT ON A 
PAPER TAPE. 

/O OUTPUT LISTING WITH BINARY CODE IN OCTAL FORMAT. - 

THE GENERATED BINARY CODE IS NORMALLY PRINTED IN 
HEXADECIMAL AT THE LEFT OF THE PROGRAM STATEMENTS 
IN THE LISTING FILE. THE /O OPTION WILL CAUSE THE 
BINARY CODE TO BE LISTED IN OCTAL INSTEAD OF 
HEXADECIMAL. 

/N LIST ONLY THE SYMBOL TABLE. - 

THE THIRD PASS LISTING NORMALLY CONSISTS OF THE 
STATEMENT LISTING PLUS THE USER SYMBOL TABLE 
LISTING. THE /N OPTION CAUSES ONLY THE SYMBOL TABLE 
TO BE LISTED. 

/P INCLUDE NORMALLY UNLISTED PSEUDO-OPS IN THE LISTING- 

SOME PSEUDO-OPS WILL NOT BE LISTED BY PASS 3 UNLESS 
THE /P OPTION IS USED. 

/S OMIT THE SYMBOL TABLE FROM LISTING. - 

ONLY THE PROGRAM STATEMENTS ARE LISTED WITH THIS 
OPTION. 













TABLE #1. RUN-TIME OPTIONS. < CQNT. ) #2. 4. 0 


OPTION MEANING INVERT? 

**#******#**■**##*#*##**#*########*#*#####*####•****#*#•»• ■#••«••«• ■#••*■#•#•«••«•■#•## 

/T REPLACE FORM/FEED WITH 3 CR/LF'S. 

WHEN LISTING TO A DEVICE SUCH AS A TTY WHICH DOES 
NOT HAVE A FORM/FEED CONTROL, USE OF THE /T OPTION 
WILL REPLACE THE FORM/FEED WITH 3 BLANK LINES . 

/W INHIBIT WARNING MESSAGES. ‘ - 

WHEN WARNING MESSAGES CAN BE SAFELY IGNORED, THIS 
OPTION WILL PREVENT THEM FROM BEING OUTPUT. 

/O USER FLAGS, USED WITH THE ? OPERATOR, SEE SECTION 

TO /9 # 8. 1. 4 . 


# 3. 0. 0 ASSEMBLER CHARACTER SET. 


THE FOLLOWING CHARACTERS ARE LEGAL SOURCE CODE CHARACTERS: 

1) ALPHABETICS A-Z, UPPER CASE ASCII 

2) NUMERICS 0-9 

3) THE SPECIAL CHARACTERS LISTED BELOW. 

*##*#**###*•«• ■fi-****##**#####*#**#***#*#*##*###***#****#*###** 

* MULTIPLICATION 

/ DIVISION 

& BOOLEAN AND 

! INCLUSIVE OR 

•+• ADDITION 

SUBTRACTION 

C 3 PRECEDENCE INDICATORS 

UNIVERSAL UNARY OPERATOR <U?ARROW). USED WITH: 

'•■C - COMPLEMENT (UPARROW C) 

•"'B - BINARY RADIX INDICATOR (UPARROW B) 

A D - DECIMAL RADIX INDICATOR < UPARROW D) 

~H - HEXADECIMAL RADIX INDICATOR (UPARROW H) 
■M3 - OCTAL RADIX INDICATOR (UPARROW 0) 

•'-L - LEAST SIGNIFICANT BYTE ACCESS OPERATOR 
"'M - MOST SIGNIFICANT BYTE ACCESS OPERATOR 
i COMMENT INDICATOR 

" OR •' ASCII INDICATOR 

? USER FLAG OPERATOR 

CURRENT LOCATION COUNTER <PERIOD) 









# 3. 0. 0 


THE CARRIAGE RETURN CHARACTER IS RECOGNIZED AS THE TERMINATOR FOF 
EACH SOURCE LINE. THE LINE-FEED, RIJBOUT, FORM-FEED, AND NULL 
CHARACTERS ARE IGNORED BY THE ASSEMBLER. FORM-FEED CHARACTERS 
OCCURING IN THE SOURCE HAVE NO AFFECT ON THE LISTING. ALL ASCII 
CHARACTERS MAY BE USED IN THE COMMENT FIELD OF A STATEMENT. 


# 4. 0. 0 STATEMENT FORMAT. 


STATEMENTS ARE WRITTEN IN THE GENERAL FORM: 

LABEL OPERATOR OPERAND ;COMMENT 

LABELS MUST START IN COLUMN 1. THEY MAY BE DIRECTLY FOLLOWED WITF 
AN OPTIONAL COMMA IF DESIRED. THE MODIFICATION NOTES EXPLAIN HOW TC 
REPLACE THE COMMA WITH ANOTHER DELIMITER SUCH AS A COLON. 

OPERATORS MUST BE SEPARATED FROM THE LABEL WITH AT LEAST ONE SPACE 
OR TAB. WHEN NO LABEL IS PRESENT, THE OPERATOR MAY BEGIN IN ANN 
COLUMN BEYOND COLUMN 1. 

THE OPERAND (IF ANY) MUST BE SEPARATED FROM THE OPERATOR WITH A1 
LEAST ONE SPACE OR TAB. 

THE COMMENT (IF ANY) MUST BE SEPARATED FROM THE OPERAND (OF 

OPERATOR IF THERE IS NO OPERAND BY A SEMICOLON (; ). 

AN INPUT LINE MAY BE UP TO 127 CHARACTERS LONG (NOT INCLUDING THE 

CARRIAGE RETURN). WHEN THE INPUT LINES ARE OUTPUT TO THE LISTING 

FILE, ANY CHARACTERS AFTER THE 72D COLUMN ARE WRITTEN ON THE NEX1 

LINE(S) BEGINNING AT THE 25TH COLUMN OF THE FIRST SOURCE LINE 
(NORMAL COMMENT COLUMN). SEE THE MODIFICATION NOTES IN SECTIOIn 
#11.0.0 TO ADJUST FOR NARROWER OR WIDER PAGE OUTPUT. THE CARRIAGE 
RETURN IS A TERMINATOR FOR BOTH THE STATEMENT AND THE LINE. ONLV 
ONE STATEMENT IS ALLOWED PER 127 CHARACTER LINE. 




# 4. 1. 0 


# 4. 1. O CODING CONVENTIONS: 


ALTHOUGH THE ASSEMBLER WILL ACCEPT PROGRAMS WRITTEN IN FREE FORMAT, 
THE USE OF TABS MAKES FOR MORE READABLE CODE. TAB STOPS ARE SET 
EVERY 8 CHARACTERS IN THE LINE SO THAT THE USE OF THE TAB KEY 
SIMPLIFIES INPUT. GENERALLY: 


LABELS 

OCCUPY 

THE 

FIRST 

TAB 

FIELD, 

COLUMNS 

1 

THROUGH 

8 

OPERATORS 

OCCUPY 

THE 

SECOND 

TAB 

FIELD, 

COLUMNS 

9 

THROUGH 

16. 

OPERANDS 

OCCUPY 

THE 

THIRD 

TAB 

FIELD, 

COLUMNS 

17 

THROUGH 

24. 

COMMENTS 

OCCUPY 

THE 

REMAINING 1 

FIELDS, 

COLUMNS 

25 

THROUGH 

127. 


# 4. 2. 0 LABELS. 


A LABEL IS A SYMBOL WHICH PRECEDES THE OPERATOR AND MUST FOLLOW THE 
SYMBOL NAMING CONVENTIONS DESCRIBED IN SECTION # 6.2.0 . IN ALL BUT 
THE SYMBOL DEFINITION PSEUDO-OPS, (. EQU, . SET, . DINST ) THE LABEL 
IS A LOCATION TAG AND IS EQUAL TO THE VALUE OF THE CURRENT LOCATION 


COUNTER. 





EXAMPLE: 

2 

1 

. ORG 

201 


0 

6 

LABEL1 . EQU 

6 

; LABEL1=6 

201 1 


LABEL2 . BYTE 

1 

; LABEL2=L0CATION TAG=201 


NOTE THAT A JUMP TO LABEL1 WILL TRANSFER TO ADDRESS 6 WHILE A JUMP 
TO LABEL2 GOES TO ADDRESS 201. 

A LABEL LACKING BOTH AN OPERATOR AND OPERAND IS SET EQUAL TO THE 
VALUE OF THE NEXT ADDRESS TO BE ASSEMBLED. IF USED AT THE 
BEGINNING OF THE PROGRAM, IT IS SET EQUAL TO THE VALUE OF THE FIRST 
ADDRESS. WHEN A SOLITARY LABEL IS FOLLOWED BY AN . ORG STATEMENT, 
IT RETAINS THE ORIGINAL VALUE ASSIGNED BEFORE THE ORIGIN CHANGE. 


# 4. 3. 0 OPERATORS. 


AN OPERATOR IS A MNEMONIC WHICH INDICATES THE ACTION TO BE 
PERFORMED AND IS EITHER A PSEUDO-OP OR ONE OF THE MICROPROCESSOR 
INSTRUCTIONS. PSEUDO-OPS ARE DESCRIBED IN SECTION #9. 0. 0. THE 
MICROPROCESSOR INSTRUCTION SET IS DESCRIBED IN SECTION #13. 0. 0 . 
THESE OPERATORS SHOULD NOT BE CONFUSED WITH ARITHMETIC OPERATORS 
USED IN OPERAND EXPRESSIONS. 



# 4. 4. 0 OPERANDS. 


# 4. 4. 0 


AN OPERAND REPRESENTS THE PART OF THE INSTRUCTION WHICH IS TO BE 
ACTED ON. IT CAN BE A TERM OR AN EXPRESSION. 

THE . BYTE, . DBYTE, AND . ADDR PSEUDO-OPS CAN HAVE MULTIPLE OPERANDS. 

REFER TO THE EXPLANATION OF EACH OPERATOR FOR THE PROPER OPERAND 
FORMAT. 

IT SHOULD BE NOTED THAT OPERAND EXPRESSIONS ARE EVALUATED TO A 
SINGLE NUMERICAL VALUE BY THE ASSEMBLER. BINARY CODE IS NOT 
GENERATED TO MAKE THE MICROPROCESSOR EVALUATE THE EXPRESSION. 


# 4. 5. O TERMS AND EXPRESSIONS. 


A TERM IS A SINGLE VALUE, A CONSTANT OR SYMBOL. THE CURRENT 
LOCATION COUNTER (REPRESENTED BY A PERIOD) IS CONSIDERED A TERM. 

TERMS ARE COMBINED WITH OPERAND ARITHMETIC OPERATORS TO FORM 
EXPRESSIONS. 

EXAMPLE: IN THE INSTRUCTION BELOW THE OPERAND IS AN EXPRESSION 
WHICH HAS TWO ARITHMETIC OPERATORS AND THREE TERMS. 

SYMBOL . EQU 1+NEW * 15 

16 BIT INTEGER ARITHMETIC IS USED TO EVALUATE EXPRESSIONS. 


# 5. 0. 0 NUMERIC CONSTANTS. 


A CONSTANT IS A NUMERIC VALUE REPRESENTED EY A STRING OF DIGITS. 
THE DEFAULT RADIX OR TEMPORARY RADIX INDICATORS IDENTIFY THE RADIX 
OF THE CONSTANT. A CONSTANT WITHOUT ANY TEMPORARY RADIX INDICATOR 
IS CONSIDERED TO BE IN THE DEFAULT RADIX, WHICH IS INITIALLV 
HEXADECIMAL. 

EXAMPLE: THE HEXADECIMAL NUMBER 16 (22 IN BASE 10) IS STORED IN 

"VALUE" : 

0 16 VALUE . EQU 16 

THE MAXIMUM VALUE FOR A CONSTANT IS 65535 (BASE 10 UNSIGNED). 


THE MINIMUM VALUE FOR A CONSTANT IS -32768 (BASE 10 SIGNED). 






# 5. 1. 0 CONSTANTS WITH RADIX INDICATORS. 


# 5. 1. 0 


CONSTANTS IN A BASE DIFFERENT FROM THAT OF THE DEFAULT RADIX CAN BE 
SPECIFIED THROUGH USE OF THE TEMPORARY RADIX INDICATORS. THESE 
INDICATORS ARE VERY USEFUL FOR ENTERING INDIVIDUAL CONSTANTS. 
HOWEVER, IF A LARGE GROUP OF VALUES IN ANOTHER RADIX MUST BE 
ENTERED, IT IS MORE CONVENIENT TO CHANGE THE DEFAULT RADIX USING 
THE PSUEDO-OPS DESCRIBED IN SECTION # 9. 2. 0 . 

THE TEMPORARY RADIX INDICATORS ARE: 


•"'B BINARY 

~D DECIMAL 

•"“H HEXADECIMAL 

^O OCTAL 


THE IS THE UPARROW CHARACTER (UNIVERSAL UNARY OPERATOR). 

A HEXADECIMAL CONSTANT WHICH DOES NOT BEGIN WITH A NUMBER SHOULD BE 
WRITTEN WITH A LEADING ZERO TO DISTINGUISH IT FROM FROM A SYMBOL. A 
RADIX INDICATOR PRECEDING A SYMBOL IS IGNORED. 

EXAMPLE: THE FIRST STATEMENT IS VALID, THE SECOND IS NOT. 

VALUE . EQU ''H0A302 ; VALUE=A302, BASE 16 

VALUE . EQU A HA302 ;VALUE = SYMBOL A302 

SINCE THE SYMBOL A302 MAY NOT EXIST, THE SECOND STATEMENT WILL 
PROBABLY CAUSE AN UNDEFINED SYMBOL ERROR. TEMPORARY RADIX 
INDICATORS AFFECT THE NEXT DIGIT STRING IN THE EXPRESSION UNLESS A 
SYMBOL NAME OR BINARY OPERATOR OCCURS FIRST. IN THAT CASE, THE 
TEMPORARY RADIX INDICATOR WOULD BE IGNORED. NO ERROR MESSAGE IS 
GIVEN. 


# 5.2.0 CONSTANTS WITH ASCII INDICATORS. 


THE " AND ' INDICATORS ARE USED TO FORM THE 7 BIT ASCII VALUE OF A 
CHARACTER. THERE ARE FOUR ACCEPTABLE WAYS TO WRITE THE INDICATORS: 

"A" OR "A OR 'Pi' OR •'A ALL EQUAL 41 (BASE 16). 

NOTE THAT THE CLOSING QUOTE IS OPTIONAL, BUT IF USED IT MUST MATCH 
THE OPENING QUOTE. ONLY ONE CHARACTER CAN FOLLOW THE INDICATOR. 

THE " IS SPECIALLY HANDLED IN THE . BYTE PSEUDO-OP WHERE IT IS USED 
TO INPUT TEXT STRINGS. SEE SECTION # 9. 3. 1 . 





# 6 . 0 . 0 


# 6. 0. 0 SYMBOLS. 


THE WORD "SYMBOL" IS USED HERE AS A GENERAL TERM FOR ANY MNEMONII 
WHICH IS TO HAVE A VALUE. THIS IS IN CONTRAST TO AN OPERATOR* WHIG! 
IS A MNEMONIC WHICH SPECIFIES A PROCESS. 

A LABEL IS A SYMBOL THAT PRECEDES AN OPERATOR IN THE STATEMENT. II 
THE LABEL IS USED TO STORE THE VALUE OF THE CURRENT LOCATIOI 
COUNTER * IT IS CALLED A LOCATION TAG. 


# 6. 1. 0 PERMANENT SYMBOLS. 


PERMANENT SYMBOLS ARE THE CROSS-ASSEMBLER PSEUDO-OPS ANI 
MICROPROCESSOR OPERATORS. IF NECESSARY, THE . DINST STATEMENT CAN Bl 
USED TO RENAME A MICROPROCESSOR OPERATOR. THE CROSS-ASSEMBLEI 
PSEUDO-OPS CANNOT BE USED IN A . DINST INSTRUCTION. THE TABLES II 
THE APPENDICES SUMMARIZE THE PERMANENT SYMBOL SET. 


# 6. 2. 0 USER DEFINED SYMBOLS. 


THESE SYMBOLS CAN BE LOCATION TAGS OR REPRESENT A VALUE. 

A SYMBOL IS A STRING OF FROM ONE TO SIX ALPHANUMERIC CHARACTER: 
DELIMITED BY A NON-ALPHANUMERIC CHARACTER. USER-DEFINED SYMBOL: 
MUST CONFORM TO THE FOLLOWING RULES: 

1) THE CHARACTERS MUST BE LEGAL ALPHA-NUMERICS. 

(A-Z OR 0—9 ) 

2) THE FIRST CHARACTER MUST BE ALPHABETIC (A-Z). 

3) ONLY THE FIRST SIX CHARACTERS ARE USED, ANY 
OTHERS ARE IGNORED. SYMBOLS ARE STORED IN THE 
SYMBOL TABLE AND REFERENCED ONLY BY THE FIRST 
SIX CHARACTERS. 

4) A USER-DEFINED SYMBOL CANNOT HAVE THE SAME 
NAME AS ANY OF THE PERMANENT SYMBOL NAMES. 

AS THE PERIOD IS CONSIDERED AS PART OF THE 
ASSEMBLER PSEUDO-OP NAME, A USER-DEFINED SYM¬ 
BOL WHICH IS IDENTICAL EXCEPT FOR THE LEADING 
PERIOD IS LEGAL. 






# 6. 3. 0 


# 6. 3. 0 LOCAL SYMBOLS. 


OFTEN, WHEN PROGRAMMING SHORT SECTIONS OF CODE WHICH INVOLVE 
NUMEROUS JUMP OR BRANCHING INSTRUCTIONS, THE USER FINDS IT 
DIFFICULT TO CREATE MEANINGFUL LABELS THAT WILL NOT CONFLICT WITH 
OTHER SYMBOLS IN THE PROGRAM. IN CASES LIKE THIS, LOCAL SYMBOLS CAN 
BE USED INSTEAD OF REGULAR SYMBOLS. 

LOCAL SYMBOLS HAVE THE FORMAT "$N" WHERE "N" IS A DECIMAL INTEGER 
FROM 0-255 INCLUSIVE. 

LOCAL SYMBOLS MUST BE DEFINED AND REFERENCED WITHIN LOCAL SYMBOL 
BLOCKS. LOCAL SYMBOL BLOCKS ARE SECTIONS OF THE PROGRAM THAT START 
ON A STATEMENT HAVING A REGULAR SYMBOL USED AS A LOCATION TAG AND 
END ON THE STATEMENT JUST BEFORE THE OCCURANCE OF THE NEXT REGULAR 
SYMBOL LOCATION TAG. NOTE THAT LABELS FOR THE . EQU, . DINST AND 
SET PSEUDO-OPS ARE NOT LOCATION TAGS AND DO NOT DELIMIT LOCAL 
SYMBOL BLOCKS. 

THERE IS NO EFFECTIVE LIMIT TO THE SIZE OF A LOCAL SYMBOL BLOCK. 

THE SAME LOCAL SYMBOL CAN BE DEFINED AND USED IN AN UNLIMITED 
NUMBER OF LOCAL SYMBOL BLOCKS. 

EXAMPLE: 


TAG1 

. BYTE 

"TEXT" 

;SYMBOL BLOCK BEGINS 

$1 

. EQU 

VALUE 

>DEFINE LOCAL $1 

$2 

. EQU 

-1 

;DEFINE LOCAL %2 

VALU1 

. EQU 

$l-*2 

i CALCULATE NEW VALUE 

TAG2 

. BYTE 

"TEXT" 

i NEW SYMBOL BLOCK 

$1 

. EQU 

VALU1 

i DEFINE LOCAL 

$2 

. EQU 

-2 

i DEFINE LOCAL $2 

VALU2 

. EQU 

$1*$2 

i CALCULATE NEW VALUE. 

TAGS 

. BYTE 

"TEXT" 

iENDS SECOND BLOCK 


# 7. 0. 0 CURRENT LOCATION COUNTER. 


THE CURRENT LOCATION COUNTER IS INDICATED BY A PERIOD. IT 
REPRESENTS THE ADDRESS OF THE NEXT BYTE TO BE ASSEMBLED. 

THE CURRENT LOCATION COUNTER CANNOT BE USED IN THE LABEL FIELD. 






# 7. 0. 0 


AT THE BEGINNING OF THE SOURCE INPUT THE CURRENT LOCATION COUNTER 
IS SET TO ZERO. IT CAN BE REASSIGNED THROUGH USE OF THE . ORG 
PSEUDO-OP. 

EXAMPLE: 


0 

60 


. ORG 

60 

i INITIAL ADDRESS 

0 

0 

VALUE 

. EQU 

0 

; NO EFFECT ON . 

60 22 


TAG- 

. BYTE 

22 

; . = 60 (BASE 8) 

1 

00 


. ORG 

100 

; REASSIGN COUNTER 

100 10 


TAG! 

. BYTE 

10 

i .= 100 


LOCATION TAGS ARE ALWAYS SET EQUAL TO THE VALUE OF THE CURRENT 
LOCATION COUNTER WHEN THEY ARE ASSEMBLED. IN THE EXAMPLE ABOVE, THE 
LOCATION TAG "TAG" = 60. 

THE CURRENT LOCATION COUNTER IS AUTOMATICALLY UPDATED IN THE 
ASSEMBLER AS SOON AS THE CURRENT INSTRUCTION IS ASSEMBLED. NOTE 
THAT IN THE MULTI-OPERAND DATA STORAGE PSEUDO-OPS, (. BYTE, . DBYTE, 
AND . ADDR ) THE LOCATION COUNTER IS CHANGING AS THE OPERANDS ARE 
ASSEMBLED. 

EXAMPLE: THE LOCATION COUNTER IS USED AS AN OPERAND 3 TIMES IN AN 

. ADDR PSEUDO-OP. 

0 20 

20 20 0 
22 22 0 
24 24 0 

20 20 0 

THE CURRENT LOCATION COUNTER USES THE FULL ADDRESS RANGE OF THE 
MICROPROCESSOR. 


. ORG 20 

. ADDR 


# 8. 0. 0 THE ARITHMETIC OPERATOR SET. 


THERE ARE TWO TYPES OF ARITHMETIC OPERATORS: UNARY AND BINARY 
OPERATORS. 


UNARY OPERATORS ACT 
FOLLOWING THEM. 

ON 

ONLY 

ONE ITEM, 

THE 

TERM 

OR 

EXPRESSION 

BINARY OPERATORS 

ACT 

ON 

TWO ITEMS: 

THE 

TERM 

OR 

EXPRESSION 

PRECEEDING THEM AND 

THE 

TERM 

OR EXPRESION 

FOLLOWING 

THEM. 






# 8 . 1 . 0 


# 8. 1. 0 UNARY OPERATORS. 


THE + (PLUS) AND - (MINUS) UNARY OPERATORS ASSIGN A POSITIVE OR 
NEGATIVE SIGN TO THE EXPRESSION FOLLOWING THEM. AN EXPRESSION IS 
ASSUMED TO BE POSITIVE IF NOT OTHERWISE SPECIFIED. 


# 8. 1. 2 BYTE ACCESS OPERATORS. 


THE •''L AND -*M (WHERE "• IS THE UPARROW CHARACTER) ARE UNARY 
OPERATORS WHICH PROVIDE ACCESS TO THE LEAST AND MOST SIGNIFICANT 8 
BIT BYTES OF THE VALUE OF AN EXPRESSION OR TERM. 

EXAMPLE: TO SET "VALUE" EQUAL TO THE MOST SIGNIFICANT BYTE OF 
3B61 (BASE 16), THE STATEMENT BELOW IS USED. 

VALUE . SET '"M3B61 ; VALUE ■ 003B 

THIS NEXT STATEMENT TAKES THE LEAST SIGNIFICANT BYTE. 

VALUE .SET A L3B61 iVALUE ■ 0061 

BYTE ACCESS OPERATORS MAY BE COMBINED WITH THE OTHER UNARY 
OPERATORS AND THE RADIX INDICATORS. 


# 8. 1. 3 THE COMPLEMENT OPERATOR. 


THE •'-C (UPARROW C) IS A LOGICAL UNARY OPERATOR WHICH COMPLEMENTS 
THE EXPRESSION FOLLOWING IT. 

EXAMPLE: 

VALUE . EQU A C7241 ;VALUE * 8DBE 

THE COMPLEMENT OPERATOR CAN BE COMBINED WITH THE OTHER UNARY 
OPERATORS AND THE RADIX INDICATORS. 






# 8. 1. 4. ? OPERATOR. 


# 8. 1. 4 


THIS IS THE USER FLAG OPERATOR, A UNARY OPERATOR USED IN CONJUNC¬ 
TION WITH THE COMMAND DECODER USER FLAG OPTIONS </0 TO /':■>). IT HAS 
THE FORM 7EXPRESSI0N AND MAY BE USED IN OPERANDS LIKE ANY OTHER 
TERM. THE RESULTING VALUE OF THE QUESTION MARK OPERATOR EQUALS 1 IF 
THE VALUE OF ITS EXPRESSION MATCHES A USER FLAG THAT WAS SPECIFIED 
TO THE COMMAND DECODER AT RUN-TIME. OTHERWISE IT EQUALS 0. THIS 
OPERATOR IS USEFUL FOR CONTROLLING CONDITIONAL ASSEMBLY AND LISTING 
PARAMETERS WITHOUT HAVING TO MODIFY THE SOURCE FILE. 

EXAMPLE: THE /2 OPTION WAS SPECIFIED TO THE COMMAND DECODER AT 
RUN-TIME. 


. R XNAME 

*BIN, LOUT<S0URCE/2 

THE SOURCE FILE CONTAINS THE FOLLOWING . LIST STATEMENTS: 


LIST ?2-l 


LIST 1 


AT THE FIRST .LIST STATEMENT, THE ?2 TERM EQUALS 1 SINCE /2 WAS 
SPECIFED AT RUN-TIME. THE OPERAND ( ?2-l ) EQUALS ZERO. THEREFORE 
LISTING IS INHIBITED UNTIL THE SECOND . LIST INSTRUCTION. AS THE 
OPERAND VALUE OF THIS STATEMENT IS 1, LISTING IS ENABLED AGAIN. 
NOTE THAT IF THE /2 OPTION WAS NOT SPECIFIED, THE INSTRUCTIONS 
AFTER THE FIRST .LIST WOULD BE INCLUDED IN THE "LOUT" FILE LISTING. 


# 8. 2. 0 BINARY OPERATORS. 


SIX SPECIAL CHARACTERS ARE USED TO PERFORM THE FOLLOWING BINARY 
OPERATIONS: 


* MULTIPLICATION 

/ DIVISION 

& BOOLEAN AND 

! INCLUSIVE OR 

+ ADDITION 

SUBTRACTION 






THE UNARY OPERATORS TAKE PRECEDENCE OVER THE BINARY OPERATORS 
DURING ASSEMBLY. THE * AND / OPERATORS ARE EXECUTED NEXT , THEN THE 
OTHER BINARY OPERATORS FROM LEFT TO RIGHT. BRACKETS; C AND 3; ARE 
USED TO CHANGE THE ORDER OF PRECEDENCE WHEN NECESSARY. A C IS A 
SHIFT/K ON TTY KEYBOARDS, AND A 3 IS A SHIFT/M. 

EXAMPLE: IN THE STATEMENT BELOW THE OPERAND EXPRESSION IS EVALUATED 
IN THIS ORDER: C A* C -B 3 3 + C C 2/D 3 * C ~C C ''B101 3 3 3 

VALUE . EQU A*-B+2/D*'-C"-B101 

ADDITION AND SUBRACTION ARE ACCOMPLISHED BY TWO'S COMPLEMENT 16 BIT 
ARITHMETIC. NO CHECKS FOR OVERFLOW ARE MADE. 

MULTIPLICATION IS ACCOMPLISHED BY REPEATED ADDITION. NO CHECKS FOR 
SIGN OR OVERFLOW ARE MADE. 

DIVISION IS ACCOMPLISHED BY REPEATED SUBRACTIQN. THE QUOTIENT IS 
THE NUMBER OF SUBTRACTIONS PERFORMED. THE REMAINDER IS NOT SAVED. 
NO CHECKS ARE MADE FOR SIGN. DIVISION BY ZERO RESULTS IN ZERO. 

THE BOOLEAN AND FUNCTION <&) IS A BIT BY BIT LOGICAL AND OF TWO 
NUMBERS: 

THE BOOLEAN INCLUSIVE OR (!) IS A BIT BY BIT LOGICAL OR OF TWO 
NUMBERS. 



# 9. 0. O PSEUDO-OPERATORS. 


# 9. 0. 0 


PSEUDO-OPERATORS ARE INSTRUCTIONS TO THE ASSEMBLER WHICH ALLOU 
GREATER FLEXIBILTIY IN PROGRAMMING. 

A SUMMARY OF THE PSEUDO-OPS AND THEIR FUNCTIONS IS GIVEN IN THE 
APPENDIX. 


# 9. 1. 0 ASSIGNMENT PSEUDO-OPS. 


ASSIGNMENT PSEUDO-OPS ARE USED TO DEFINE VALUES* INPUT ASCII TEX1 
AND REASSIGN THE LOCATION COUNTER. 


# 9. 1. 1 . EQIJ PSEUDO-OP. 


THE . EQU IS USED TO ASSIGN A VALUE TO A SYMBOL. THIS SYMBOL VALUE 
CANNOT BE CHANGED ONCE DEFINED. . EQU IS USEFUL FOR ASSIGNING NAMES 
TO LOCATIONS WHICH ARE NOT LOADED BY THE OBJECT CODE. 

EXAMPLE: 


NAME1 . EQU 300*6 


# 9. 1. 2 . SET PSEUDO-OP. 


THE . SET IS USED EXACTLY LIKE THE . EQU EXCEPT THAT THE SYMBOL CAh 
BE REDEFINED WITH ANOTHER . SET AT ANY POINT IN THE PROGRAM: 

EXAMPLE: THE FOLLOWING IS PERFECTLY LEGAL FOR A . SET BUT NOT M 
. EQU. 


NAME1 . SET 300*6 
NAME1 . SET 22 

NOTE THAT IT IS GOOD PRACTICE TO USE THE . EQU FOR ASSIGNMENTS 
RATHER THAN THE . SET EXCEPT (OF COURSE) WHERE THERE IS A SPECIFIC 
NEED TO REDEFINE A VALUE. THIS HELPS PREVENT THE ACCIDENTAL 
REDEFINITION OF A VALUE IN A PROGRAM. 


# 9. 1. 3 . DINST PSEUDO-OP. 


THE . DINST IS USED TO GIVE A MICROPROCESSOR OPERATOR ANOTHER NAME. 
THE ORIGINAL OPERATOR NAME WILL STILL BE VALID. NOTE THAT THE 
ASSEMBLER PSEUDO-OPS CANNOT BE RENAMED. 








#9. 1. 3 


EXAMPLE: THE MICROPROCESSOR INSTRUCTION "OPR" IS DEFINED AS 
"NEWOP". ANY FURTHER REFERENCES TO "NEWOP" IN THE PROGRAM WILL BE 
TREATED ACCORDING TO THE DEFINITION OF "OPR". 

NEWOP . DINST OPR 

"NEWOP" IS DEFINED TO BE THE EQUIVALENT TO THE MICROPROCESSOR 
INSTRUCTION "OPR" AND IS ADDED TO THE OPERATOR SET FOR THE 
REMAINDER OF THE ASSEMBLY. 

REFERENCES TO USER DEFINED OPERATORS ARE NOT ALLOWED TO PRECEDE 
THEIR . DINST STATEMENT. 

ASSEMBLER PSEUDO-OPS CANNOT BE USED IN EITHER THE LABEL OR OPERAND 
FIELDS OF ANY STATEMENT AND THEREFORE CANNOT BE DEFINED WITH THE 
. DINST STATEMENT. 

LOCAL SYMBOLS CANNOT BE USED IN THE OPERATOR FIELDS, THEREFORE THEY 
SHOULD NOT BE USED WITH A . DINST STATEMENT. 


# 9. 1. 4 . ORG PSEUDO-OP. 


THE . ORG REASSIGNS THE LOCATION COUNTER. 

THE LOCATION COUNTER WILL BE 0 AT THE START OF THE SOURCE INPUT. 

THE . ORG OPERAND CANNOT BE FORWARD REFERENCED, (REFERRED TO A 
LABEL DEFINED FURTHER ON IN THE PROGRAM) AND CANNOT HAVE A LABEL. 


# 9. 2. 0 DEFAULT RADIX PSEUDO-OPS. 


INITIALLY, THE DEFAULT RADIX IS SET TO HEXADECIMAL SO THAT 
CONSTANTS ARE READ IN AS BASE 16 VALUES. <SEE MODIFICATION NOTES IF 
ANOTHER INITIAL DEFAULT RADIX IS DESIRED. ) 

AT ANY POINT IN THE PROGRAM, THE DEFAULT RADIX CAN BE REASSIGNED 
THROUGH USE OF THESE PSEUDO-OPS: 


. BIN 
. DECM 
. HEX 
. OCT 


;BINARY RADIX 
i DECIMAL RADIX 
iHEXADECIMAL RADIX 
; OCTAL RADIX 


THE DEFAULT RADIX PSEUDO-OPS CANNOT HAVE AN OPERAND OR A LABEL. 

ADDITIONALLY, THE RADIX OF INDIVIDUAL CONSTANTS CAN BE SPECIFIED BY 
THE USE OF THE •"'D, A D, '"‘H AND ''0 INDICATORS. SEE SECTION # 5. 1. 0 . 
THESE INDICATORS DO NOT CHANGE THE DEFAULT RADIX. 






# 9. 3. 0 DATA STORAGE PSEUDO-OPS. 


# 9. 3. 0 


THREE PSEUDO-OPS CAN BE USED TO STORE DATA. THEIR FORMAT IS: 

LABEL PSEUDO-OP OPERAND;OPERAND, .... iCOMMENT 

THE PSEUDO-OPS CAN HAVE AS MANY OPERANDS AS WILL FIT ON ONE 127 
CHARACTER LINE. 

EACH OPERAND CAN BE A SYMBOL,CONSTANT, OR EXPRESSION. COMMAS 
SEPARATE THE OPERANDS. 

THE DOUBLE QUOTE <") CHARACTER IS USED DIFFERENTLY IN THE .BYTE 
COMMAND, BUT THE SINGLE QUOTE (') RETAINS ITS NORMAL FUNCTION. 


# 9. 3. 1 . BYTE PSEUDO-OP. 


THE . BYTE PSEUDO-OP STORES DATA IN SINGLE BYTES OF MEMORY. 
NUMERICAL BYTE VALUES CAN RANGE FROM -128 TO +255 (DECIMAL). 

NORMALLY, DOUBLE QUOTES AND SINGLE QUOTES ARE TREATED IDENTICALL'i 
AND ARE USED TO FORM THE ASCII VALUE OF A SINGLE CHARACTER. 

HOWEVER, IN THE . BYTE PSEUDO-OP , THE DOUBLE QUOTE IS USED TO INDI¬ 
CATE TEXT STRINGS. DATA IS STORED SEQUENTIALLY AS IT IS PROCESSED, 
LEFT TO RIGHT. A TEXT STRING MUST BE CLOSED WITH A DOUBLE QUOTE. 

EXAMPLE: THE ASCII VALUES OF THE TEXT ABC IS STORED: 

2 00 . ORG 200 

200 41 .BYTE "ABC",0,'B 

201 42 

202 43 

203 0 

204 42 

THESE STATEMENTS WOULD BE INVALID: 

. BYTE •'ABC-' i THE ' IS NOT FOR TEXT STRINGS 

. BYTE "ABC ;TEXT MUST END WITH A " 


# 9. 3. 2 . DBYTE PSEUDO-OP. 


THE . DBYTE IS SIMILAR TO THE . BYTE EXCEPT THAT IT STORES DOUBLE 
BYTE QUANTITIES. IT DOES NOT ACCEPT TEXT STRINGS. THE THE MOS" 
SIGNIFICANT BYTE IS STORED FIRST, THEN THE LEAST SIGNIFICANT BYTE. 






# 9. 3. 3 . ADDR PSEUDO-OP. 


# 9. 3. 3 


THE . ADDR PSEUDO-OP IS THE SAME AS THE . DBYTE PSEUDO-OP EXCEPT THAT 
THE LEAST SIGNIFICANT BYTE IS STORED FIRST. MANY MICROPROCESSORS 
USE THIS REVERSED FORMAT FOR ADDRESSES. FOR EXAMPLE: 


2 

00 

ORG 

200 


200 1 

32 

DBYTE 

'"H3132 

; HEX CONSTANT 

202 32 

31 

ADDR 

•''H3132 

; REVERSED BYTES 

# 9. 3. 4 

. ZERO 

PSEUDO- 

-OP. 



THE . ZERO PSEUDO-OP RESERVES THE NUMBER OF BYTES INDICATED BY THE 
OPERAND AND SETS THEM TO ZERO. 

EXAMPLE: 16 ADDRESSES, 1 TO 10 (BASE 16) ARE ZEROED. 

0 1 . ORG 1 

1 0 . ZERO 10 

1110 . BYTE 10 

ONLY THE FIRST BYTE WILL BE PRINTED IN THE LISTING. THE LOCATION 
COUNTER IS ADVANCED. THE OPERAND OF . ZERO CANNOT BE FORWARD REFER¬ 
ENCED, (REFERED TO A LABEL DEFINED FURTHER ON IN THE PROGRAM). 


# 9. 4. 0 LISTING CONTROL DIRECTIVES. 


THROUGH USE OF THE .LIST, . PAGE AND . TITLE PSEUDO-OPS, PLUS SEVERAL 
RUN-TIME OPTIONS, THE SOURCE PROGRAM CAN BE LISTED IN VARIOUS WAYS 
AT ASSEMBLY TIME. 

NORMALLY, THE ASSEMBLER AUTOMATICALLY PAGES THE OUTPUT, ADDING A 
HEADER AT THE TOP OF THE PAGE. (NOTE THAT PAGE NUMBERS REPRESENT 
THE LISTING PAGE NUMBERS, NOT INPUT FILE PAGES. ) 

NOT ALL PSEUDO-OPS ARE LISTED IN THE OUTPUT. THE CONDITIONAL 
ASSEMBLY AND LISTING CONTROL PSEUDO-OPS ARE NOT LISTED UNLESS THE 
/P OPTION IS SPEC I FED. SEE RUN-TIME OPTIONS # 2. 4. 0 . 

NORMALLY THE STATEMENTS WHICH ARE NOT ASSEMBLED DUE TO CONDITIONAL 
ASSEMBLY ARE NOT LISTED. USE OF THE /J COMMAND DECODER OPTION WILL 
ENABLE LISTING OF THESE STATEMENTS PLUS THE NORMALLY UNLISTED 
CONDITONAL ASSEMBLY PSUEDO-OPS. 

THE PAGINATION AND HEADING CAN BE SUPPRESSED THROUGH USE OF THE /H 
COMMAND DECODER OPTION. 






# 9 . 4 . 0 


IF THE OUTPUT DEVICE IS ONE WHICH DOES NOT PAGE ON A FORM FEED if 
TTY), THE /T DECODER OPTION CAN BE USED TO CHANGE THE FORM FEEE 
(WHICH NORMALLY STARTS A NEW PAGE) TO 3 CARRIAGE RETURN/LINE FEEDS 
SO THAT PAGES WILL BE SEPARATED BY 3 BLANK LINES IN THE LISTING. 

WARNING MESSAGES ARE NORMALLY OUTPUT TO BOTH THE TERMINAL AND THE 
SOURCE LISTING. TO INHIBIT THESE MESSAGES, THE /W DECODER OPTION IS 
USED. 


# 9. 4. 1 .LIST PSEUDO-OP. 


A LIST FLAG IS USED DURING ASSEMBLY TO INDICATE WHETHER OR NOT THE 
STATEMENTS ARE TO BE LISTED. INITIALLY, THE FLAG IS ON AND STAYS Oh 
UNLESS A .LIST PSEUDO-OP IS ENCOUNTERED. 


A .LIST PSEUDO-OP CAN BE USED WITH OR WITHOUT AN OPERAND. A LABEL 
CANNOT BE USED WITH THE . LIST PSEUDO-OP. 


WHEN A .LIST PSEUDO-OP WITHOUT AN OPERAND IS ENCOUNTERED, THE LISI 
FLAG IS INVERTED. 


EXAMPLE: 


i LIST FLAG INITIALLY ON 



. ORG 

200 

; LISTED 

VALUE 

. SET 

1 

; LISTED 


. LIST 


i LIST FLAG OFF 

VALU2 

. SET 

70 

; NOT LISTED 


. LIST 


; LIST FLAG BACK ON 


NOTE THAT UNLESS THE /P OPTION IS USED, THE . LIST OPERATOR ITSELF 
WILL NOT BE LISTED. 


WHEN A .LIST PSEUDO-OP WITH AN OPERAND IS ENCOUNTERED, THEN LISTINC 
IS INHIBITED IF THE OPERAND IS EQUAL TO ZERO. (THE LIST FLAG IS 
SET OFF). IF THE OPERAND IS NOT ZERO, LISTING IS ENABLED. (THE 
LIST FLAG IS SET ON). 


# 9. 4. 2 . PAGE PSEUDO-OP. 


INSERTING A . PAGE PSEUDO-OP IN THE PROGRAM WILL NORMALLY START f 
NEW PAGE BEGINNING WITH THE NEXT LINE. (THE . PAGE STATEMENT ITSELF 
IS NOT NORMALLY LISTED. ) IF THE /P COMMAND DECODER OPTION IS USED, 
THE . PAGE STATEMENT WILL BE THE FIRST LINE OF THE NEW PAGE. 







# 9. 4. 2 




THE /H COMMAND DECODER OPTION INHIBITS THE . PAGE PSEUDO-OP. 
THE . PAGE PSEUDO-OP CAN HAVE NO LABEL OR OPERAND. 


# 9. 4. 3 . TITLE PSEUDO-OP. 


THE . TITLE IS USED TO REPLACE THE HEADING WITH UP TO 32 CHARACTERS 
OF TEXT. ITS FORMAT IS: 

. TITLE HEADING OF 32 CHARACTERS 

THE FIRST CHARACTER AFTER THE . TITLE IS THE PSEUDO-OP DELIMITER 
WHICH CANNOT BE AN ALPHA-NUMERIC CHARACTER . THE DELIMITER IS 
CONSIDERED THE FIRST CHARACTER OF THE 32 CHARACTER GROUP AND WILL 
BE PRINTED OUT. ANY TEXT AFTER 32 CHARACTERS WILL BE IGNORED. TABS 
CAN BE USED IN THE HEADING. 

THE /H COMMAND DECODER OPTION INHIBITS THE . TITLE PSEUDO-OP. 

THE /P COMMAND DECODER ENABLES THE LISTING OF THE . TITLE PSEUDO-OP. 

A SEMICOLON DOES NOT DELIMIT THE HEADING TEXT. COMMENTS CAN BE 
MADE ONLY AFTER THE 32 CHARACTER HEADING GROUP. 

WHEN PLACED AT THE BEGINNING OF THE PROGRAM, THE . TITLE PSEUDO-OP 
WILL SET THE HEADING FOR THE FIRST PAGE. THE . TITLE MUST APPEAR 
BEFORE THE FIRST LINE TO BE LISTED. 

EXAMPLE: THE FOLLOWING STATEMENTS WILL CAUSE THE HEADING OF THE 

FIRST PAGE TO BE "*MAIN PROGRAM". 

. TITLED-MAIN PROGRAM 
VALUE . EQU 1 

. LIST VALUE 


# 9. 5. 0 CONDITIONAL ASSEMBLY PSUEDO-GPERATORS. 


THE . IFZERO, . IFNZRO, . IFDEF AND . IFNDEF OPERATORS ARE USED TO 
PROVIDE FOR THE CONDITIONAL ASSEMBLY IN A PROGRAM, SO THAT GROUPS 
OF STATEMENTS CAN BE ADDED (OR OMITTED) DURING THE ASSEMBLY 
PROCESS. EACH IS DESCRIBED INDIVIDUALLY IN THE SECTIONS THAT 
FOLLOW. ALL HAVE THE GENERAL FORM: 

PSEUDO-OP OPERAND ;COMMENT 





# 9. 5. 0 


EACH OPERAND MUST MEET THE CONDITIONS OF ITS PSEUDO-OP IN ORDER FOF 
THE STATEMENTS THAT FOLLOW IT TO BE ASSEMBLED. IF THE CONDITION? 
ARE NOT MET; THESE STATEMENTS ARE OMITTED. THE . ENDC PSEUDO-OF 
INDICATES THE END OF THE GROUP OF STATEMENTS WHICH ARE AFFECTED. 
EACH CONDITIONAL PSEUDO-OP MUST HAVE ONE . ENDC STATEMENT. 

CONDITIONAL PSEUDO-OPS CANNOT HAVE LABELS. 

CONDITIONAL PSEUDO-OPS CAN BE NESTED UP TO 4095 LEVELS. 


EXAMPLE: 


VALUE1 

. EQU 

0 

;DEFINE VALUE1 


. IFZERO 

VALUE1 

; VALUE! = 0 ? - YES. 


. BYTE 

"TEXT" 

; ASSEMBLED. 


. IFDEF 

VALUE2 

; VALUE2 DEFINED? - NO. 


. BYTE 

"TEXT" 

; OMITTED. 


. ENDC 


;END OF INNER CONDITIONAL 

DOC 

. EQU 

17 

; ASSEMBLED. 


. ENDC 


; END OF OUTER CONDITIONAL 


THE CONDITIONAL PSEUDO-OPS ARE NOT INCLUDED IN THE ASSEMBLY LISTINi 
UNLESS THE /P OR /J COMMAND DECODER OPTION IS SPECIFIED. 

ONE CONDITIONAL CAN INHIBIT ANOTHER. 

EXAMPLE: THREE DIFFERENT RESULTS CAN OCCUR IN THE FOLLOWING TYPE 01 
CONDITIONAL NESTING: 


CONDITIONAL 1 
CONDITIONAL 2 


; STATEMENT GROUP 1. 
; STATEMENT GROUP 2. 


. ENDC 
. ENDC 


; END CONDITIONAL 2. 
; STATEMENT GROUP 3. 
; END CONDITIONAL 1. 


IF BOTH CONDITIONALS ARE MET, ALL THE STATEMENTS; GROUPS 1 THROUGI 
3; WILL BE ASSEMBLED. 

IF CONDITIONAL 2 IS NOT MET, BUT CONDITONAL 1 IS MET, THEN GROUP 
AND GROUP 3 WILL BE ASSEMBLED. GROUP 2 IS NOT ASSEMBLED. 

IF CONDITIONAL 1 IS NOT MET, CONDITIONAL 2 IS IGNORED AND GROUPS 
THROUGH 3 WILL NOT BE ASSEMBLED. 





# 9. 5. 1 . IFZERO PSEUDO-OP. 


# 9 . 5 . 1 


IF THE OPERAND OF THE . IFZERO IS: 

EQUAL TO ZERO - ASSEMBLY IS UNAFFECTED. 

NOT EQUAL TO ZERO - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

THE OPERAND CANNOT BE FORWARD REFERENCED. 

# 9. 5. 2 . IFNZRO PSEUD-OP. 

IF THE OPERAND OF THE . IFNZRO IS: 

EQUAL TO ZERO - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

NOT EQUAL TO ZERO - ASSEMBLY IS UNAFFECTED. 

THE OPERAND CANNOT BE FORWARD REFERENCED. 

# 9. 5. 3 . IFDEF PSEUDO-OP. 

IF THE SYMBOL OPERAND OF THE . IFDEF IS: 

DEFINED - ASSEMBLY IS UNAFFECTED. 

NOT DEFINED - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

NOTE THAT . IFDEF WILL ACCEPT ONLY A SINGLE SYMBOL NAME AS THE 

OPERAND. 

A SYMBOL IS CONSIDERED TO BE DEFINED IF IT HAS BEEN USED IN THE 
LABEL FIELD OF A STATEMENT PRECEEDING THE CONDITIONAL PSEUDO-OP. 

# 9. 5. 4 . IFNDEF PSEUDO-OP. 

IF THE SYMBOL OPERAND OF THE . IFNDEF IS: 

DEFINED - STATEMENTS TO NEXT . ENDC ARE OMITTED. 

NOT DEFINED - ASSEMBLY IS UNAFFECTED. 

NOTE THAT ONLY A SINGLE SYMBOL NAME IS ALLOWED AS THE OPERAND. 

A SYMBOL IS CONSIDERED TO BE DEFINED IF IT HAS BEEN USED IN THE 

LABEL FIELD OF A STATEMENT PRECEEDING THE CONDITIONAL PSEUDO-OP. 







# 9. 5. 5 . ENDC PSEUDO-OP. 


# 9 . 5 . 5 


THIS PSEUDO-OP INDICATES THE END 
EVERY CONDITIONAL PSUEDO-OP MUST 


OF A CONDITONAL ASSEMBLY GROUP. 
BE PAIRED WITH A . ENDC. 


# 9. 6. 0 . END PSEUDO-OP. 


THIS INDICATES THE END OF THE SOURCE PROGRAM. IT CANNOT HAVE EITHEF 
A LABEL OR AN OPERAND. A WARNING MESSAGE WILL OCCUR IF THE . ENI 
STATEMENT IS LEFT OFF. 


#10. 0. 0 ERROR MESSAGES AND WARNINGS. 


BOTH PASS #1 AND PASS #2 CAN GENERATE ERROR MESSAGES. THESE ARE 
PRINTED ON THE CONSOLE DEVICE AS THEY OCCUR. IF A LISTING IS 
SPECIFIED, PASS 3 WILL LIST THE ERROR MESSAGE ABOVE THE LINE Ih 
WHICH THE ERROR OCCURS. 

ERROR MESSAGES WHICH ARE SENT TO THE CONSOLE HAVE THE FORM: 

E:XX AT LABEL+N 

WHERE "N" IS A DECIMAL NUMBER OF 
LINES BEYOND THE STATEMENT WHICH 
CONTAINED THE GIVEN LABEL. IF NO 
LABEL WAS GIVEN, "N" IS THE NUMBER OF 
LINES FROM THE BEGINNING LINE OF THE 
PROGRAM. 

IF THE BINARY OUTPUT FILE IS SENT TO THE CONSOLE, AND ERROF 
MESSAGES OCCUR, THE OUTPUT FILE LINES AND ERROR MESSAGES WILL BE 
INTERMIXED. USE OF THE /E OPTION WILL INHIBIT THE ERROR MESSAGES 
TO THE CONSOLE SO THAT ONLY THE BINARY FILE IS OUTPUT. THIS IS 
USEFUL WHEN A USER WOULD LIKE TO TRY OUT CERTAIN PARTS OF A PROGRAF 
AND IS NOT YET CONCERNED WITH OTHER PARTS KNOWN TO HAVE ERRORS. 






INDIVIDUAL ERROR MESSAGES ARE EXPLAINED IN TABLE #2 WHICH DIVIDES 
THE MESSAGES INTO THREE TYPES: 

1) FATAL ERRORS- THESE ERRORS CAUSE THE IMMEDIATE 
EXIT TO THE OS/8 MONITOR. THE CURRENT OUTPUT FILE 
IS NOT CLOSED. /E WILL NOT INHIBIT FATAL ERROR 
MESSAGES. FATAL ERROR MESSAGES ARE ALWAYS SENT TO 
THE CONSOLE DEVICE. 

2) WARNING MESSAGES INDICATE MINOR PROGRAM 
PROBLEMS. ASSEMBLY IS NOT HALTED. GOOD PROGRAMMING 
PRACTICES WILL ELIMINATE ALL WARNING MESSAGES. 

3) NON-FATAL ERRORS - THE OCCURANCE OF A NON-FATAL 
ERROR WILL NOT HALT ASSEMBLY. THE ASSEMBLER 
ATTEMPTS TO DO AS MUCH OF THE LINE AS POSSIBLE. FOR 
EXAMPLE, IF THE OPERAND CANNOT BE EVALUATED, IT 
GIVES IT A VALUE OF ZERO, WRITES THE ERROR MESSAGE 
AND CONTINUES. 



TABLE #2. #10. 0. 0 

#**# FATAL ERRORS **** 

E:DF - DEVICE FULL: 

FILE #N THERE IS NOT ENOUGH ROOM LEFT ON THE OUTPUT DEVICE 

FOR THE FILE. "N" INDICATES WHICH OF THE TWO OUT¬ 
PUT FILES WAS IN ERROR. 

E:LT - LOCAL SYMBOL TABLE OVERFLOW: 

THIS ERROR OCCURS ONLY IF THE /K OPTION IS IN USE. 
CONVERSION OF SOME OF THE LOCAL SYMBOLS TO REGULAR 
SYMBOL NAMES WILL USUALLY SOLVE THIS PROBLEM. SEE 
THE NOTES ON THE /K RUN-TIME OPTION. 

E:OE - OPEN ERROR IN OUTPUT FILE: 

FILE #N AN ATTEMPT WAS MADE TO OPEN AN OUTPUT FILE ON AN 

INPUT-ONLY DEV IDE. <PTR:, CDR: < ETC.) "N" INDICATES 
WHICH ONE OF THE TWO POSSIBLE OUTPUT FILES WAS IN 
ERROR. 

E:PE - PHASE ERROR: 

A LOCATION TAG HAS A DIFFERENT ADDRESS IN ONE PASS 
THAN IT HAD IN THE PREVIOUS PASS. 

E:RE - READ ERROR: 

FILE #N AN ERROR HAS OCCURRED WHILE READING FROM AN INPUT 

FILE DEVICE. "N" INDICATES WHICH ONE OF THE NINE 
POSSIBLE INPUT FILES HAD THE ERROR. 

E:ST - SYMBOL TABLE OVERFLOW: 

THE PROGRAM IS TOO LARGE. WHERE CONVENIENT, DIVIDE 
IT AND ASSEMBLE EACH PART SEPARATELY. ALSO REFER TO 
THE NOTES ON THE /K RIJN-TIME OPTION. 

E:WE - WRITE ERROR: 

FILE #N AN ERROR HAS OCCURRED WHILE WRITING TO AN OUTPUT 

FILE DEVICE. "N M INDICATES WHICH ONE OF THE TWO 
OUTPUT FILES HAD THE ERROR. 

*■*•«■* WARNING MESSAGES **** 

W:EF - NO . END STATEMENT: 

THE LAST INPUT FILE MUST HAVE AN . END STATEMENT. 
THE ASSEMBLER PROCEEDS AS IF AN . END WERE PRESENT. 

W:UC - ASSEMBLY WAS CONDITIONALLY INHIBITED AT THE END OF 

THE PROGRAM: EACH CONDITIONAL ASSEMBLY PSEUDO-OP 

MUST BE PAIRED WITH AN . ENDC STATEMENT. 





TABLE #2. (CGNT. ) #10. 0. 0 

**** NON-FATAL ERRORS ***•*' 

E:BN - BAD NESTING OF BRACKETS: 

EACH OPEN BRACKET MUST BE PAIRED WITH A CLOSED 
BRACKET. 

E: DR - DIGIT OUTSIDE OF RADIX: 

THE CONSTANT CONTAINS A DIGIT NOT RECOGNIZED UNDER 
THE SPECIFIED RADIX. FOR EXAMPLE* THE DIGIT "2" IS 
NOT RECOGNIZED IN BINARY RADIX. THE CONSTANT WILL 
BE EVALUATED AS IF THAT DIGIT WERE ZERO. 

E:IL - ILLEGAL LABEL FIELD: 

THE LABEL MAY NOT BE IN THE PROPER SYMBOL FORMAT, 
SEE SECTION #6. 2. 0 . ALSO, SOME PSEUDO-OPS CANNOT 
HAVE LABELS. 

E:10 - ILLEGAL OPERAND VALUE: 

REFER TO THE SECTION ON THE STATEMENT'S OPERATOR TO 
DETERMINE THE ALLOWABLE OPERAND TERMS. 

E:LO - LINE INPUT OVERFLOW: 

ONLY 127 CHARACTERS, NOT INCLUDING THE CARRIAGE 
RETURN AND LINE FEED, ARE ALLOWED IN AN INPUT LINE. 

E: LS - LOCAL SYMBOL SYNTAX ERROR: 

THE CORRECT FORMAT FOR A LOCAL SYMBOL IS *N WHERE 
"N“ IS A DECIMAL NUMBER FROM 0 TO 255. 

E: ML - MULTIPLE LABEL DEFINITION: 

THE SAME LABEL HAS A DIFFERENT VALUE AND IS USED 
WITH AN OPERATOR OTHER THAN A . SET PSEUDO-OP. 

E:MO - MISSING OR ILLEGAL MNEMONIC IN OPERATOR FIELD: 

E: OC - OPERAND TOO COMPLEX: 

TOO MANY TERMS AND OPERATORS EXIST IN THE OPERAND. 
DIVIDE THE EXPRESSION USING THE . SET COMMAND. 

EXAMPLE: THE FIRST EXPRESSION IS DIVIDED INTO THE 

TWO STATEMENTS FOLLOWING IT. 


WORD 

. EQU 

C 

EXPR1 3 + C EXPR2 3 

TEMP 

. SET 

c 

EXPR1 3 

WORD 

. EQU 

TEMP + C EXPR2 3 


E: OM - OPERAND MISSING. 





TABLE #2. <CONT. ) 


#10. 0. 0 




E: OS - OPERAND SYNTAX ERROR. 

E:PS - ILLEGAL PERMANENT SYMBOL USAGE IN OPERAND: 

REFER TO THE APPENDICES TABLES TO SEE WHICH NAMES 
ARE USED IN THE ASSEMBLER AND MICROPROCESSOR IN¬ 
STRUCTION SETS AND RENAME YOUR SYMBOL SO THAT IT 
WILL NOT CONFLICT. 


E:TL - LABEL DEFINED TOO LATE: 

ONLY ONE LEVEL OF FORWARD • REFERENCING IS ALLOWED. 


E.US - UNDEFINED SYMBOL: 




NOTE: REFER TO SECTION #12. 0. 0 FOR ADDITIONAL ERROR MESSAGES WHICH 

ARE SPECIFIC TO THE TYPE OF MICROPROCESSOR BEING USED. 


#11.0.0 MODIFICATION NOTES. 


VARIOUS MODIFICATIONS CAN BE MADE TO THE ASSEMBLER FOR GREATER 
OPERATING CONVENIENCE. BEFORE MAKING ANY CHANGES, THE USER SHOULD 
READ THE DESCRIPTION OF EACH OPTION CAREFULLY. NO CHECKS ON PATCH 
VALIDITY ARE MADE. ALSO KEEP A RECORD OF ALL CHANGES SO THAT THE 
STATUS OF THE CROSS-ASSEMBLER IS ALWAYS KNOWN. 

MODIFICATIONS ARE MADE BY PATCHING LOCATIONS IN THE IMAGE <.SV) 
FILE USING ODT. REFER TO THE OS/8 MANUAL FOR A DETAILED EXPLAN¬ 
ATION OF ODT OPERATION. 

THE EXAMPLE BELOW SHOWS AN ODT PATCH BEING MADE TO FILE "XNAME. SV" 
WHERE THE CONTENT OF LOCATION 10107 IS CHANGED FROM 3 TO 2. 

. GET SYS:XNAME 
. ODT 

10107/0003 2 

Ap 

. SA SYS: XNAME 




# 11 . 1 . 0 


#11. 1.0 CHANGING THE DEFAULT INPUT FILE EXTENSION (.MS). 


PATCH LOCATION 10100 TO CONTAIN THE NEW 2 CHARACTER 6 BIT ASCII 
EXTENSION. 


#11.2.0 CHANGING THE DEFAULT BINARY OUTPUT FILE EXTENSION (.MB) 


PATCH LOCATION 10101 TO CONTAIN THE NEW 2 CHARACTER 6 BIT ASCII 
EXTENSION. 


#11.3.0 CHANGING THE DEFAULT LISTING OUTPUT FILE EXTENSION (.LS). 


PATCH LOCATION 10102 TO CONTAIN THE NEW 2 CHARACTER 6 BIT ASCII 
EXTENSION. 


#11. 4. 0 CHANGING THE BASE YEAR DATE. 


IN OS/8 ONLY 3 BITS ARE PROVIDED TO INDICATE THE CURRENT YEAR. 
THIS ALLOWS ONLY NUMBERS FROM 0 TO 7 WHICH MUST BE ADDED TO A BASE 
YEAR TO FORM THE ACTUAL YEAR NUMBER. IN 1978 AND AT ADDITIONAL 8 
YEAR INTERVALS THE BASE YEAR MUST BE CHANGED TO PROVIDE THE PROPER 
DATE PRINTOUT. TO DO THIS, PATCH LOCATION 10104 TO CONTAIN THE TWO 
CHARACTER 6 BIT ASCII REPRESENTATION OF THE TWO LEAST SIGNIFICANT 
DIGITS OF THE YEAR. 

BASE YEAR: PATCH TO LOCATION 10104 (IN OCTAL). 

1978 6770 
1986 7066 
1994 7164 
2002 6062 

SHOULD THIS PROGRAM SURVIVE UNTIL THE YEAR 2000 THE TWO MOST 
SIGNIFICANT DIGITS MAY BE CHANGED BY PATCHING LOCATION 10103 TO 
CONTAIN 6260. 






#11. 5. 0 


#11.5.0 CHANGING THE DEFAULT RADIX. (HEXADECIMAL) 


INITIALLY THE DEFAULT RADIX IS SET TO HEXADECIMAL. THIS MAY BE 
MODIFIED TO BINARY, OCTAL, OR DECIMAL BY PATCHING LOCATION 10105 
FROM THE FOLLOWING TABLE. 

RADIX: PATCH LOCATION 10105 TO: 


OCTAL 1 
HEXADECIMAL 2 
DECIMAL 3 
BINARY 4 


#11.6.0 GENERATING 8 BIT ASCII CHARACTERS WITHIN THE BINARY 
PROGRAM. 


THE ASCII CHARACTERS GENERATED AS OPERANDS WITH THE QUOTE 
CHARACTERS ARE SEVEN BIT REPRESENTATIONS TYPICAL OF MOST 
MICROPROCESSOR SYSTEMS. TO GENERATE EIGHT BIT ASCII WITH THE 
EIGHTH BIT ALWAYS SET (AS IS DONE IN SOME PDP8 SOFTWARE), PATCH 
LOCATION 10106 TO CONTAIN 377. (ORIGINAL CONTENT WAS 177). 


#11.7.0 RUNNING UNDER OSS VERSION 2. 


THE CROSS-ASSEMBLER IS SET UP TO USE THE OS/8 VERSION 3 METHOD FOR 
CORE SIZE DETERMINATION. IN OS/8 V3 THE CORE SIZE IS CONTAINED IN 
A MONITOR LOCATION. IN PREVIOUS VERSIONS, THE CORE SIZE MUST BE 
DETERMINED BY ACCESSING EACH FIELD OF MEMORY TO SEE IF IT EXISTS ON 
THE SYSTEM. THEREFORE , TO RUN THE CROSS-ASSEMLER UNDER VERSION 2, 
PATCH LOCATION 10107 TO CONTAIN 2. (ORIGINAL CONTENT WAS 3). 


#11.8.0 CHANGING THE NUMBER OF LINES PER PAGE. (6) 


THE NORMAL NUMBER OF LINES PER PAGE IS SET AT 66. 6 OF THE 6 t 
LINES ARE USED BY THE ASSEMBLER FOR THE HEADING AND MARGIN. TC 
ALTER THE NUMBER OF LINES ON A PAGE, PATCH LOCATION 10110 TO BE THE 
TOTAL POSITIVE LINES PER PAGE INCLUDING HEADING AND MARGIN. 







#11. 9. 0 


#11.9.0 CHANGING THE NUMBER OF CHARACTERS PER LINE. (72) 


THE TOTAL NUMBER OF CHARACTERS PRINTED ON ONE LINE (EXCLUDING 
CARRIAGE RETURN AND LINE FEED) IS SET AT 72 (BASE 10). TO MODIFY 
THIS COUNT, PATCH LOCATION 10111 TO CONTAIN THE POSITIVE NUMBER OF 
CHARACTERS TO BE PRINTED ON A LINE (EXCLUDING THE CR AND LF). 


#11. 10.0 INITIAL FORM/FEED CONTROL. 


SOME LINE PRINTER HANDLERS WHEN FIRST INITIALIZED WILL ISSUE AN 
AUTOMATIC FORM FEED. TO AVOID EJECTING AN ADDITIONAL PAGE EACH TIME 
THE ASSEMBLER IS CALLED, THE FIRST FORM FEED FROM THE HEADING HAS 
BEEN SUPPRESSED. TO REENABLE THIS FIRST FORM FEED, PATCH LOCATION 
10112 WITH 214 (BASE 8). 


#11. 11. 0 CHANGING LABEL DELIMINATOR (, ). 


TO PROVIDE COMPATIBILITY WITH OTHER ASSEMBLER FORMATS AN OPTIONAL 
LABEL DELIMITER WILL BE ACCEPTED. NORMALLY, THIS DELIMITER IS A 
COMMA, BUT IT CAN BE MODIFIED TO ANY OTHER NON-ALPHANUMERIC- 
CHARACTER (EXCEPT THE SEMICOLON OR CARRIAGE RETURN). TO MODIFY THE 
DELIMITING CHARACTER PATCH LOCATION 10113 WITH THE 8 BIT ASCII 
VALUE FOR THE CHARACTER. 


#11. 12. 0 CHANGING FROM 8 BIT TO 7 BIT ASCII IN THE OUTPUT FILES. 


ALL ASCII OUTPUT TO THE BINARY (OBJECT) AND LISTING FILES IS IN 8 
BIT ASCII FORMAT. TO OUTPUT 7 BIT ASCII FORMAT PATCH LOCATION 10114 
TO CONTAIN 177. (ORIGINAL CONTENT WAS 377). 







#11. 13. 0 

#11. 13.0 CHANGING THE SENSE OF THE RIJN-TIME OPTIONS. 


EACH SLASH OPTION (EXCEPT /O TO /9> 
PATCHING THE LOCATIONS SHOWN IN 
DESCRIBED VALUE. 


OPTION: LOCATION: 


/B 

10116 

7650 

/E 

10117 

7640 

/H 

10120 

7650 

/J 

10121 

7650 

/K 

10122 

7650 

/L 

10123 

0 

/N 

10124 

7650 

/O 

10125 

7650 

/P 

10126 

7640 

/S 

10127 

7650 

/T 

10130 

7650 

/W 

10131 

7650 


MAY HAVE ITS SENSE INVERTED BV 
THE FOLLOWING TABLE WITH THE 


STANDARD: INVERTED: 

7640 

7650 

7640 

7640 

7640 

1 

7640 

7640 

7650 

7640 

7640 

7640 






#12. 0. 0 6800 CROSS-ASSEMBLER SPECIFICS. 


# 12 . 0 . 0 


THE FIRST ELEVEN SECTIONS OF THIS MANUAL HAVE PRESENTED SIERR* 
DIGITAL'S UNIVERSAL ASSEMBLER FORMAT AS IT IS APPLIED TO ALL CROSS- 
ASSEMBLERS IN THE X3 SERIES. THIS SECTION PRESENTS ADDITIONAL 
INFOMATIQN ON THE APPLICATION OF THE UNIVERSAL ASSEMBLER FORMAT TC 
A SPECIFIC CROSS-ASSEMBLER FOR THE 6800 MICROPROCESSOR. THE 680C 
MICROPROCESSOR WAS DESIGNED BY MOTOROLA SEMICONDUCTOR PRODUCTS 
INC. , BOX 20912, PHOENIX, ARIZONA 85036. THE 6800 IS PRODUCED BN 
MOTOROLA SEMICONDUCTOR PRODUCTS INC. AND ALSO SECOND SOURCED BN 
AMERICAN MICROSYSTEMS, INC. , 3800 HOMESTEAD ROAD, SANTA CLARA, 
CALIFORNIA, 95051. NO ATTEMPT WILL BE MADE IN THIS MANUAL TC 
EXPLAIN THE OPERATION OF THE MIROPROCESSOR. EXCELLENT MANUALS 
COVERING THE OPERATION AND PROGRAMMING OF THE MICROPROCESSORS ARE 
AVAILABLE FROM THEIR MANUFACTURERS. SECTION #13 PRESENTS A SUMMARN 
OF THE INSTRUCTION MNUEMONIC CODES AND ADDRESSING MODES DEFINED BN 
MOTOROLA AND RECOGNIZED BY OUR CROSS-ASSEMBLER. 


#12. 1.0 CROSS ASSEMBLER FILE NAMES. 


THE CROSS-ASSEMBLER IS PROVIDED ON FILE STRUCTURED MEDIA UNDER THE 
NAMES: 

X6800. SV - FOR THE OS/8 SAVE IMAGE FILE. 

X6800. BN - FOR THE OS/8 BINARY FORMAT FILE. 

IT IS SUGGESTED THAT THE SAME NAMING CONVENTIONS BE USED WHEI" 
LOADING THE CROSS-ASSEMBLER FROM PAPER TAPE. 





# 12 . 2 . 0 # 12 . 2 . 0 

ADDRESSING MODE REQUIREMENTS. 


THE 6800 MICROPROCESSOR SUPPORTS SEVERAL ADDRESSING MODES AS 
DESCRIBED FULLY BY THE MANUFACTURER'S MANUAL. A SUMMARY OF THE 
IMPORTANT OPERAND REQUIREMENTS IS PRESENTED HERE. THE INSTRUCTION 
TABLE IN SECTION #13 SHOWS ALL THE POSSIBLE ADDRESSING MODES FOR 
EACH OPERATOR AND ITS ASSEMBLY SOURCE CODE FORMAT. THE 'OPER' 
SHOWN AS AN EXAMPLE IN THE OPERAND FIELD OF MANY INSTRUCTIONS 
REPRESENTS THE VALUE OR ADDRESS TO BE OPERATED ON. THE 'OPER - ' MAY 
BE A SINGLE TERM OR A COMPLEX EXPRESSION REDUCEABLE BY THE 
ASSEMBLER TO A SINGLE QUANTITY (REFER TO SECTION #4 ON STATEMENT 
FOMAT). FOR MANY INSTRUCTIONS THE VALUE OF THE OPERAND DETERMINES 
THE DIFFERENCE IN ADDRESSING MODES (DIRECT VS EXTENDED). OTHER 
ADDRESSING MODES HAVE RESTRICTED VALUES ON THEIR OPERANDS AS 
DESCRIBED IN THE FOLLOWING TABLE: 

ADDRESSING MODE: MEANING: 

INHERENT - NO OPERAND IS ALLOWED. 

IMMEDIATE - THE OPERAND VALUE MUST BE IN THE RANGE -128 
TO +255 (DECIMAL). TWO'S COMPLEMENT 8 BIT 
VALUES ARE USED. 

DIRECT - THE OPERAND REPRESENTS AN ADDRESS IN THE BASE 

PAGE AND THEREFORE MUST FALL WITHIN THE RANGE 
OF 0 TO 255 (DECIMAL). 

EXTENDED - THE OPERAND REPRESENTS AN ADDRESS WITHIN THE 

RANGE 0 TO 65,535 (DECIMAL). IN CASES WHERE 
DIRECT MODE IS ALSO AVAILABLE, VALUES FROM 
0 TO 255 (DECIMAL) WILL AUTOMATICALLY USE 
DIRECT (BASE PAGE) ADDRESSING. 

INDEXED - THE OPERAND VALUE MUST BE A SINGLE BYTE AND 

THEREFORE IS RESTRICTED TO VALUES BETWEEN 
0 AND 255 (DECIMAL). WHEN THE VALUE IS TO BE 
ZERO, THE OPERAND (AND COMMA) MAY BE OMITTED. 

RELATIVE - THE OPERAND VALUE MUST BE AN ADDRESS WHICH IS 

WITHIN -128 TO +127 BYTES FROM FIRST BYTE OF 
THE NEXT INSTRUCTION. 

FOR ALL INSTRUCTIONS INVOLVING ACCUMULATOR ADDRESSING, THE 
CHARACTER -'A-' OR 'B' DENOTING THE ACCUMULATOR MAY BE COMBINED WITH 
THE INSTRUCTION MNEMONIC CODE. THUS 'ADC B OPER-' MAY BE WRITTEN 
AS 'ADCB OPER-' . 




#12. 3. 0 


#12. 3. 0 RESERVED CHARACTERS. 


THE SINGLE CHARACTERS 'A', 'B', AND 'X' ARE RESERVED FOR USE AS 
INDICATORS FOR THE TWO ACCUMULATORS AND THE X-INDEX REGISTER. 
THEIR USAGE IS AS SHOWN IN THE ASSEMBLY CODE COLUMN OF THE 
INSTRUCTION TABLES IN SECTION #13. THESE CHARACTERS CANNOT BE USED 
AS STANDARD SYMBOL NAMES AND WILL ONLY BE RECOGNIZED WHEN USED AS 
DEMONSTRATED IN THE INSTRUCTION TABLES. 


#12. 4. 0 LISTING FILE FORMAT. 


THE LISTING FILE IS OUTPUT WITH THE OBJECT CODE PRINTED TO THE LEFT 
OF THE SOURCE CODE LINES. AS EACH MICROPROCESSOR INSTRUCTION MAY 
CODE INTO ONE, TWO, OR THREE BYTES, ROOM IS PROVIDED FOR THREE 
COLUMNS OF GENERATED OBJECT CODE PLUS A COLUMN FOR THE ADDRESS. THE 
ADDRESS AND OBJECT CODE ARE NORMALLY PRINTED IN HEXADECIMAL BUT 
THIS MAY BE CHANGED TO OCTAL WITH THE /O COMMAND DECODER OPTION. 
SOURCE LINES WHICH EXCEED THE PRINTOUT LIMIT WILL BE CONTINUED AT 
COLUMN 25 (STANDARD COMMENT TAB STOP) OF THE SOURCE PRINTOUT 
PORTION. TABS OCCURING IN THE SOURCE PROGRAM ARE CONVERTED TO THE 
PROPER NUMBER OF BLANK CHARACTERS BY THE ASSEMBLER. THIS IS DONE BY 
THE ASSEMBLER RATHER THAN THE DEVIDE HANDLER OR DEVICE BECAUSE THE 
BEGINNING OF THE SOURCE PRINTOUT DOES NOT OCCUR ON A STANDARD TAB 
STOP. 





#12. 5. 0 BINARY FILE OUTPUT: 


#12. 5. 0 


THE OBJECT (BINARY) OUTPUT FILE CONISTS OF ASCII TEXT REPRESENTING 
HEXADECIMAL NUMBERS IN THE FOLLOWING FORMAT: 

LEADER STRINGS OF 100 NULL CHARACTERS PRECEED AND FOLLOW THE OBJECT 
OUTPUT. EACH LINE BEGINS WITH A RECORD TYPE DESIGNATOR* SO* SI* OR 
S9. FOLLOWING COMES A TWO HEXADECIMAL DIGIT RECORD BYTE COUNT, A 
FOUR HEXADECIMAL DIGIT ADDRESS* UP TO 16 BYTES (EACH 2 HEX DIGITS)* 
AND A TWO HEX DIGIT CHECKSUM. 


EXAMPLE: 

STCCAAAADDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDXX 

WHERE: 


IS AN ASCII CHARACTER 'S' DENOTING START OF THE 
RECORD. 


T 


A SINGLE DIGIT: 

0 FOR 

HEADER RECORD 


1 FOR 

DATA RECORD 


9 FOR 

END OF FILE RECORD 


CC IS THE TWO HEXADECIMAL DIGIT COUNT FOR THE TOTAL 

NUMBER OF ADDRESS, DATA, AND CHECKSUM BYTES. (AA* 
DD, XX). 


AAAA IS THE HEXADECIMAL ADDRESS FOR STORING THE FIRST 

DATA BYTE. EACH ADDITIONAL DATA BYTE IS TO BE 
STORED IN SEQUENTIAL ADDRESSES. THE ADDRESS IS 
PRESENTED WITH ITS MOST SIGNIFICANT BYTE FIRST. 

DD REPRESENTS TWO HEXADECIMAL DIGITS FOR A BYTE OF 

OBJECT (BINARY CODE). UP TO 16 BYTES MAY BE OUTPUT 
ON ONE LINE. 

XX IS THE TWO HEXADECIMAL DIGIT CHECKSUM FORMED SUCH 

THAT WHEN ADDED TO THE SUM OF THE COUNT* ADDRESS* 
AND DATA BYTES IN THE RECORD* THE LEAST SIGNIFICANT 
BYTE OF THE RESULT WILL BE 'FF - ' (HEX). 


HEADER RECORDS, DENOTED BY A LEADING •'SO'* CONTAIN AN ADDRESS- 
VALUE OF ZERO AND FROM O TO 6 BYTES OF DATA REPRESENTING 7 BIT 
ASCII CHARACTERS OF A PROGRAM NAME. THE PROGRAM NAME IS TAKEN AS 
THE BINARY OUTPUT FILE NAME (LESS EXTENSION) SPECIFIED TO THE 
COMMAND DECODER. NOTE THAT A FILE NAME MAY BE ASSIGNED EVEN WHEN 
THE DEVICE IS NOT FILE STRUCTURED. THUS '*TTY: NAMECSOURCE' IS 
LEGAL AND WILL CAUSE THE ASCII VALUES FOR THE FOUR CHARACTERS 
'NAME-' TO BE PLACED IN THE BINARY HEADER RECORD. 




#12. 5. O 


END OF FILE RECORDS CONTAIN AN ADDRESS VALUE OF ZERO AND NO DATf 
BYTES. 

THE BINARY OUTPUT FILE CAN BE CHANGED TO BNPF FORMAT THROUGH USE OF 
THE /B RUN-TIME OPTION. SECTION #2. 4. 0 DESCRIBES THE BNPF OUTPUT. 


#12. 6. 0 ADDITIONAL ERROR MESSAGES FOR THE 6800: 


WARNINGS: 

W:FZ FORWARD REFERENCE TO ZERO PAGE. 

SINCE ADDRESSES MUST BE ASSIGNED DURING PASS 1, TWO 
BYTES ARE LEFT FOR THE FORWARD REFERENCED OPERAND 
ADDRESS. DURING PASS 2 THE ASSEMBLER FOUND THAT IT 
ONLY NEEDED ONE BYTE BUT SINCE TWO BYTES WERE 
RESERVED, EXTENDED ADDRESSING WAS USED. BY REMOVING 
THE FORWARD REFERENCE, AN EXTRA BYTE MAY BE SAVED. 


STANDARD ERRORS: 

E: BR BRANCH IS OUT OF RANGE. 

THE OPERAND ADDRESS WAS OUT OF RANGE FROM THE RE¬ 
QUIRED -128 TO +127 (DECIMAL) BYTES FROM THE FIRST 
LOCATION FOLLOWING THE BRANCH. 

E: BY BYTE VALUE REQUIRED. 

THE OPERAND VALUE WAS GREATER THAN 255 (DECIMAL), 
THUS EXCEEDING THE SINGLE BYTE VALUE RANGE REQUIRED 
BY THE INDEXED ADDRESSING MODE. 

E:OA ILLEGAL OPERAND ADDRESSING MODE. 

THE OPERAND ADDRESSING MODE USED DOES NOT MATCH ONE 
OF THE LEGAL ADDRESSING MODES FOR THE OPERATOR. 


X 




2. 7. 0 SAMPLE PROGRAM 


#12. 7. 0 


X6800 

TY:SAMPLE,TTY: <SAMPLE/1/P/J 
E:MO AT UPPTR + 7 

E:MO AT UPPTR + 7 

09000053414D504C4534 

131000B65C002B28962427F7B65C022AF2DE226F 
1310109C2027148D3CDF22A600B76E04C640F73F 
1310206E025FF76E0220D87F002420D3DE208D6D 
1310302190222711DF20A700C680F76E02D72447 
1310405FF76E0220BAC620F76E025FF76E023FAA 
13105020B3088C40802603CE30803941424300BF 
0610603F6333B4 
030000FC 


SAMPLE ROUTINE APR 9, 1976 X6800-V1A PAGE 1 

. TITLE SAMPLE ROUTINE 

; THIS ROUTINE ACCEPTS 7 BIT VALUES COMING IN 

i FROM INPUT PORT #1 AND PUTS THE DATA IN A 

; 4095 BYTE FIRST IN/FIRST OUT QUEUE. THE DATA 

i IS THEN RETRIEVED FROM THE QUEUE AND TRANS- 

; MITTED VIA OUTPUT PORT #2 WHEN CONDITIONS 

; PERMIT. 



5C 

0 

IP0RT1 

. EQU 

5C00 

; DEFINE I/O PORT LOCATIONS 


5C 


IP0RT2 

. EQU 

5C02 



6E 

7 

0P0RT1 

. EQU 

6E02 



6E 

4 

0P0RT2 

. EQU 

6E04 



0 

20 

INPUT 

. EQU 

20 

;QUEUE INPUT POINTER 


0 

22 

OUTPUT 

. EQU 

22 

;QUEUE OUTPUT POINTER 


0 

24 

XMTFLG 

. EQU 

24 

;TRANSMIT REQUEST FLAG 


30 

80 

BUFFER 

. EQU 

3080 

i BASE OF QUEUE BUFFER 


10 

0 


. ORG 

1000 


1000 

B6 

5C 

0 LOOP 

LDA A 

IP0RT1 

i GET READY FLAG AND DATA 

1003 

2B 

28 


BMI 

RECV 

; FOUND READY FLAG 

1005 

96 

24 

FULL 

LDA A 

XMTFLG 

; CHECK XMIT REQUEST FLAG 

1007 

27 

F7 


BEQ 

LOOP 

; NO DATA TO TRANSMIT 

1009 

B6 

5C 

2 

LDA A 

IP0RT2 

; CHECK FOR RECEIVER READY 

100C 

2 A 

F2 


BPL 

LOOP 

; RECEIVER NOT READY 

1OOE 

DE 

22 


LDX 

OUTPUT 

; CHECK QUEUE POINTERS 

1010 

9C 

20 


CPX 

INPUT 


1012 

27 

14 


BEQ 

$1 

; IP=OP, QUEUE EMPTY 

1014 

8D 

3C 


BSR 

UPPTR 

; INCREMENT POINTER 

1016 

DF 

22 


STX 

OUTPUT 

; UPDATE OUTPUT POINTER 

1018 

A6 

0 


LDA A 

X 

; GET BUFFER CONTENTS AND 

101A 

B7 

6E 

4 

STA A 

0P0RT2 

i OUTPUT 

10 ID 

C6 

40 


LDA B 

#'••801000000 ; SET HARDWARE XMIT FLAG 

101F 

F7 

6E 

2 

STA B 

0P0RT1 


1022 

5F 



CLR 

B 


1023 

F7 

6E 

2 

STA B 

OPORT1 


1026 

20 

D8 


BRA 

LOOP 


1028 

7F 

0 

24 $1 

CLR 

XMTFLG 

;CLEAR TRANSMIT FLAG 

102B 

20 

03 


BRA 

LOOP 






#12. 7. O 



SAMPLE ROUTINE 


APR 9* 

1976 X6800-V1A PAGE 2 






. PAGE 



102D 

DE 

20 


RECV 

LDX 

INPUT 

iCHECK INPUT POINTER 

102F 

8D 

21 



BSR 

UPPTR 


1031 

90 

22 



CPX 

OUTPUT 


1033 

27 

11 



BEQ 

*1 ; 

FOUND QUEUE FULL 

1035 

DF 

20 



STX 

INPUT 

;UPDATE INPUT POINTER 

1037 

A7 

0 



STA A 

X i 

STORE INCOMING DATA 

1039 

06 

80 



LDA B 

#~B10000000 iACKNOWLEDGE DATA RECEIVED 

103B 

F7 

6E 

2 


STA B 

0P0RT1 


103E 

D7 

24 



STA B 

XMTFLG i 

ALSO SET XMIT REQUEST FLAG 

1040 

5F 




CLR 

B 


1041 

F7 

6E 

2 


STA B 

0P0RT1 


1044 

20 

BA 



BRA 

LOOP 


1046 

06 

20 


$1 

LDA B 

#•'• BOO 100000 i SET HARDWARE QUEUE 

1048 

F7 

6E 

2 


STA B 

0P0RT1 ; 

FULL FLAG 

104B 

5F 




CLR 

B 


1040 

F7 

6E 

2 


STA B 

0P0RT1 







. IFZERO 

?1 ; 

USER FLAG 1 IS SELECTED FOR 






NOP 

# 

DEBUGGING. AN "SWI" IS 






. ENDC 

i 

INSERTED FOR DEBUGGING AND A 






. IFNZRO 

?1 > 

'NOP- IS INSERTED FOR NORMAL 

104F 

3F 




SWI 

t 

OPERATION 






. ENDC 



1050 

20 

B3 



BRA 

FULL 


1052 

8 



UPPTR 

INX 

i 

INCREMENT POINTER ROUTINE 

1053 

80 

40 

80 


CPX 

#BUFFER+1000 ;CHECK FOR BUFFER LIMIT 

1056 

26 

3 



BNE 

$1 ; 

NOT AT END YET 

1058 

CE 

30 

80 


LDX 

#BUFFER ; 

SET TO BEGINNING ADDRESS 

105B 

39 



$1 

RTS 







# 

SAMPLE : 

BYTE DATA 

COMMAND 

1050 

41 




. BYTE 

"ABC", 0, - 

D63, 63, '••063 


1G5D 42 
105E 43 
105F 0 

1060 3F 

1061 63 

1062 33 
**#*•»■# E: MO 

JUNK iSAMPLE ERROR 

. END 


SAMPLE ROUTINE 

3080 BUFFER 1005 

5002 IP0RT2 1000 

22 OUTPUT 102D 


APR 9, 1976 

FULL 20 INPUT 

LOOP 6E02 0P0RT1 

RECV 1052 UPPTR 


X6800-V1A PAGE 

5000 IPORT1 
6E04 0P0RT2 
24 XMTFLG 


ERRORS: 


1 



#13. 0. 0 MICROPROCESSOR INSTRUCTION SET. 


# 13 . 0 . 0 


THIS SECTION IS A SUMMARY OF THE INSTRUCTION SET OF THE 6800 MICRO¬ 
PROCESSOR AS DEFINED BY THE VENDORS. THE ASSEMBLY CODE FORMAT FOR 
EACH ADDRESSING MODE IS SHOWN WITH THE HEXADECIMAL OBJECT CODE (OP 
CODE). THE ASSEMBLER WILL CODE EACH INSTRUCTION INTO THE NUMBER OF 
BYTES GIVEN FOR EACH ADDRESSING MODE. 


ABA - ADD ACCUMULATOR 

B TO ACCUMULATOR 

A. 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

ABA 

IB 

1 


ADC - ADD WITH CARRY. 


ADDRESSING MODE ASSEMBLY CODE OP CODE NO. OF BYTES 


A 

IMMEDIATE 

ADC 

A 

#OPER 

0 v 

2 

A 

DIRECT 

ADC 

A 

OPER 

99 

2 

A 

EXTENDED 

ADC 

A 

OPER 

B9 

o 

•w* 

A 

INDEXED 

ADC 

A 

OPER, X 

A9 

Xm 

B 

IMMEDIATE 

ADC 

B 

#OPER 

C9 

2 

B 

DIRECT 

ADC 

B 

OPER 

D9 

2 

B 

EXTENDED 

ADC 

B 

OPER 

F9 

3 

B 

INDEXED 

ADC 

B 

OPER, X 

E9 

2 


ADD - ADD WITHOUT CARRY. 


ADDRESSING MODE ASSEMBLY CODE OP CODE NO. OF BYTES 


A 

IMMEDIATE 

ADD 

A 

#OPER 

8B 

2 

A 

DIRECT 

ADD 

A 

OPER 

9B 

2 

A 

EXTENDED 

ADD 

A 

OPER 

BB 

3 

A 

INDEXED 

ADD 

A 

OPER,X 

AB 

2 

B 

IMMEDIATE 

ADD 

B 

#OPER 

CB 

■y 

B 

DIRECT 

ADD 

B 

OPER 

DB 

2 

B 

EXTENDED 

ADD 

B 

OPER 

FB 

3 

B 

INDEXED 

ADD 

B 

OPER, X 

EB 

7 








AND - LOGICAL AND. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A IMMEDIATE 

AND A 

#OF‘ER 

34 

2 

A DIRECT 

AND A 

OPER 

94 

2 

A EXTENDED 

AND A 

OPER 

B4 

3 

A INDEXED 

AND A 

OPER, X 

A4 

2 

B IMMEDIATE 

AND B 

#OPER 

C4 

2 

B DIRECT 

AND B 

OPER 

D4 

2 

B EXTENDED 

AND B 

OPER 

F4 

3 

B INDEXED 

AND B 

OPER, X 

E4 

2 


ASL - ARITHMETIC 

SHIFT LEFT. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

ASL 

A 

48 

1 

B 

ASL 

B 

58 

1 

EXTENDED 

ASL 

OPER 

78 

3 

INDEXED 

ASL 

OPER, X 

68 

2 


ASR - ARITHMETIC 

SHIFT RIGHT. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

ASR 

A 

47 

1 

B 

ASR 

B 

57 

1 

EXTENDED 

ASR 

OPER 

77 

3 

INDEXED 

ASR 

OPER, X 

67 

2 


BCC - BRANCH IF 

CARRY CLEAR. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

RELATIVE 

BCC 

OPER 

24 

2 















DCS - BRANCH IF CARRY SET. 



#13. 0. 

0 

ADDRESSING NODE ASSEMBLY 

CODE 

OP CODE 

NO. OF 

BYTES 

RELATIVE BCS 

OPER 

25 

2 



BEQ - BRANCH IF EQUAL. 

ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

RELATIVE 

BEQ OPER 

27 

2 


BGE - BRANCH IF 

GREATER THAN OR 

EQUAL TO 

ZERO. 

ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE NO. OF BYTES 

RELATIVE 

BGE 

OPER 

2C '7 


BGT - BRANCH IF 

GREATER THAN ZERO. 




ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. 

OF BYTES 

RELATIVE 

BGT OPER 

2E 



BHI - BRANCH IF 

HIGHER. 




ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. 

OF BYTES 


22 


RELATIVE 


BHI 


OF'ER 
















BIT - BIT TEST. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE 

A IMMEDIATE 

BIT A 

#QPER 

35 

2 

A DIRECT 

BIT A 

OPER 

95 

2 

A EXTENDED 

BIT A 

OPER 

B5 

3 

A INDEXED 

BIT A 

OPER,X 

A5 

2 

B IMMEDIATE 

BIT B 

#OPER 

C5 

2 

B DIRECT 

BIT B 

OPER 

D5 

2 

B EXTENDED 

BIT B 

OPER 

F5 

3 

B INDEXED 

BIT B 

OPER,X 

E5 

2 


BLE - BRANCH IF LESS THAN OR EQUAL TO ZERO. 

ADDRESSING MODE ASSEMBLY CODE OP CODE 

NO. OF BYTE! 

RELATIVE BLE OPER 2F 

2 


BLS - BRANCH IF 

LOWER OR SAME. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE! 

RELATIVE 

BLS 

OPER 

23 

2 


BLT - BRANCH IF LESS THAN ZERO. 

ADDRESSING MODE ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE! 

RELATIVE BLT 

OPER 

2D 

2 















#13. 0. 0 


BMI - BRANCH IF MINUS. 

ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

RELATIVE 

BMI 

OPER 

2B 

2 


BNE - BRANCH IF NOT 

EQUAL. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

RELATIVE 

BNE 

OPER 

26 

2 


BPL - BRANCH IF 

PLUS. 







ADDRESSING MODE 


ASSEMBLY 

CODE 

OP CODE 

NO. 

OF 

BYTES 

RELATIVE 


BPL 

OPER 

2A 

2 



BRA - BRANCH ALWAYS. 

ADDRESSING MODE 


ASSEMBLY 

CODE 

OP CODE 

NO. 

OF 

BYTES 

RELATIVE 


BRA 

OPER 

20 

2 



BSR - BRANCH TO 

SUBROUTINE. 






ADDRESSING MODE 


ASSEMBLY 

CODE 

OP CODE 

NO. 

OF 

BYTES 

RELATIVE 


BSR 

OPER 

8D 

2 



















BVC - BRANCH IF OVERFLOW CLEAR. 


#13. O. O 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

RELATIVE 

BVC OPER 

28 

2 


BVS - BRANCH IF 

OVERFLOW SET. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

RELATIVE 

BVS 

OPER 

29 

2 


CBA - COMPARE ACCUMMULATORS. 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

CRA 

11 

1 


CLC - CLEAR CARRY. 


ADDRESSING MODE 

ASSEMBLY CODE 

OR CODE 

NO. OF BYTES 

INHERENT 

CLC 

oc 

1 


CLI - CLEAR INTERRUPT 

MASK. 



ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

CL I 

OE 

1 


















CLR - CLEAR. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

CLR 

A 

4F 

1 

B 

CLR 

B 

5F 

1 

EXTENDED 

CLR 

OPER 

7F 

3 

INDEXED 

CLR 

OPER, X 

6F 

2 


CLV - CLEAR TWO'S 

COMLEMENT OVERFLOW BIT. 


ADDRESSING MODE 

ASSEMBLY CODE OP CODE 

NO. OF BYTES 

INHERENT 

CLV OA 

1 


CMP - COMPARE. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A IMMEDIATE 

CMP A 

#OPER 

81 

2 

A DIRECT 

CMP A 

OPER 

91 

2 

A EXTENDED 

CMP A 

OPER 

B1 

3 

A INDEXED 

CMP A 

OPER,X 

A1 

2 

B IMMEDIATE 

CMP B 

#OPER 

Cl 

2 

B DIRECT 

CMP B 

OPER 

Di 

2 

B EXTENDED 

CMP B 

OPER 

FI 

3 

B INDEXED 

CMP B 

OPER,X 

El 

2 


COM - COMPLEMENT. 

ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

COM 

A 

43 

1 

B 

COM 

B 

53 

1 

EXTENDED 

COM 

OPER 

73 

3 

INDEXED 

COM 

OPER, X 

63 

2 












CPX 


COMPARE INDEX REGISTER. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. 

OF 

BYTES 

IMMEDIATE 

CPX 

#OPER 

80 

3 



DIRECT 

CPX 

OPER 

9C 

2 



EXTENDED 

CPX 

OPER 

BC 

3 



INDEXED 

CPX 

OPER, X 

AC 

2 



DAA - DECIMAL ADJUST 

ACCA. 






ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. 

OF 

BYTES 

INHERENT 

DAA 


19 

1 




DEC - DECREMENT. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE: 

A 

DEC 

A 

4A 

1 

B 

DEC 

B 

5A 

1 

EXTENDED 

DEC 

OPER 

7A 

3 

INDEXED 

DEC 

OPER,X 

6A 

2 


DES - DECREMENT STACK POINT. 

ADDRESSING MODE ASSEMBLY CODE 

OP CODE 

NO. OF BYTE: 

INHERENT DES 

34 

1 


DEX - DECREMENT 

INDEX REGISTER. 



ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTE 

INHERENT 

DEX 

09 

1 


















EOR - EXCLUSIVE OR. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A IMMEDIATE 

EOR A 

#OPER 

88 

2 

A DIRECT 

EOR A 

OPER 

98 

2 

A EXTENDED 

EOR A 

OPER 

B8 

3 

A INDEXED 

EOR A 

OPER, X 

AS 

2 

B IMMEDIATE 

EOR B 

#OPER 

C8 

2 

B DIRECT 

EOR B 

OPER 

D8 

2 

B EXTENDED 

EOR B 

OPER 

F8 

3 

B INDEXED 

EOR B 

OPER,X 

E8 

2 


INC - INCREMENT. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

INC 

A 

4C 

1 

B 

INC 

B 

5C 

1 

EXTENDED 

INC 

OPER 

7C 

3 

INDEXED 

INC 

OPER, X 

6C 

# 7 


INS - INCREMENT STACK POINTER. 

ADDRESSING MODE ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT INS 

31 

1 


INX - INCREMENT 

INDEX REGISTER. 



ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

INX 

08 

1 














JMP - JUMP. 


#13. O. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

EXTENDED 

JMP 

OPER 

7E 

3 

INDEXED 

JMP 

OPER, X 

6E 

2 


JSR - JUMP 

TO SUBROUTINE. 




ADDRESSING 

MODE ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

EXTENDED 

JSR 

OPER 

BD 

3 

INDEXED 

JSR 

OPER#X 

AD 

2 


LDA - LOAD ACCUMULATOR. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A IMMEDIATE 

LDA A 

#OPER 

86 

2 

A DIRECT 

LDA A 

OPER 

96 

2 

A EXTENDED 

LDA A 

OPER 

B6 

3 

A INDEXED 

LDA A 

OPER, X 

A6 

2 

B IMMEDIATE 

LDA B 

#OPER 

C6 

2 

B DIRECT 

LDA B 

OPER 

D6 

2 

B EXTENDED 

LDA B 

OPER 

F6 

3 

B INDEXED 

LDA B 

OPER# X 

E6 

2 


LDS - LOAD 

STACK 

POINTER. 




ADDRESSING 

MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

IMMEDIATE 


LDS 

OPER 

8E 

3 

DIRECT 


LDS 

OPER 

9E 

2 

EXTENDED 


LDS 

OPER 

BE 

3 

INDEXED 


LDS 

OPER# X 

AE 

2 















LDX - LOAD INDEX REGISTER. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

IMMEDIATE 

LDX 

#OPER 

CE 

3 

DIRECT 

LDX 

OPER 

DE 

2 

EXTENDED 

LDX 

OPER 

FE 

3 

INDEXED 

LDX 

OPER,X 

EE 

2 


LSR - LOGICAL SHIFT 

RIGHT. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

LSR 

A 

44 

i 

B 

LSR 

B 

54 

i 

EXTENDED 

LSR 

OPER 

74 

3 

INDEXED 

LSR 

OPER,X 

64 

2 


NEG - NEGATE. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

NEG 

A 

40 

1 

B 

NEG 

B 

50 

1 

EXTENDED 

NEG 

OPER 

70 

3 

INDEXED 

NEG 

OPER, X 

60 



NOP - NO OPERATION. 

ADDRESSING MODE 

ASSEMBLY CODE OP CODE 

NO. OF BYTES 

INHERENT 

NOP 01 

1 











ORA - INCLUSIVE OR. 




# 13 . 0 . 

0 

ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF 

BYTES 

A IMMEDIATE 

ORA A 

#OF'ER 

8 A 

2 


A DIRECT 

ORA A 

OPER 

9A 

2 


A EXTENDED 

ORA A 

OPER 

BA 

3 


A INDEXED 

ORA A 

OPER,X 

AA 

2 


B IMMEDIATE 

ORA B 

#OPER 

CA 

2 


B DIRECT 

ORA B 

OPER 

DA 

2 


B EXTENDED 

ORA B 

OPER 

FA 

3 


B INDEXED 

ORA B 

OPER, X 

EA 

7 



PSH - PUSH 

DATA ONTO 

STACK. 




ADDRESSING 

MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 


PSH 

A 

36 

1 

B 


PSH 

B 

37 

1 


PUL - PULL 

DATA FROM 

STACK. 




ADDRESSING 

MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 


PUL 

A 

32 

1 

B 


PUL 

B 

33 

1 


ROL - ROTATE LEFT. 

ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

ROL 

A 

49 

1 

B 

ROL 

B 

59 

1 

EXTENDED 

ROL 

OPER 

79 

3 

INDEXED 

ROL 

OPER, X 

69 

•*? 















#13. O. 0 


ROR - ROTATE RIGHT. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

ROR 

A 

46 

i 

B 

ROR 

B 

56 

1 

EXTENDED 

ROR 

OPER 

76 

3 

INDEXED 

ROR 

OPER, X 

66 

2 


RTI - RETURN FROM 

INTERRUPT. 



ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

RTI 

3B 

1 


RTS - RETURN FROM SUBROUTINE. 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

RTS 

39 

1 


SBA - SUBTRACT ACCUMULATORS. 

ADDRESSING MODE ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT SBA 

10 

1 


(: 

\s 










#13. 0. 0 


SBC - SUBTRACT WITH CARRY. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE? 

A IMMEDIATE 

SBC A 

#GPER 

82 

2 

A DIRECT 

SBC A 

OPER 

92 

2 

A EXTENDED 

SBC A 

OPER 

B2 

3 

A INDEXED 

SBC A 

OPER* X 

A2 

2 

B IMMEDIATE 

SBC B 

#OPER 

C2 

2 

B DIRECT 

SBC B 

OPER 

D2 

2 

B EXTENDED 

SBC B 

OPER 

F2 

3 

B INDEXED 

SBC B 

OPER, X 

E2 

2 


SEC - SET CARRY. 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTE? 

INHERENT 

SEC 

OD 

1 


SEI - SET INTERRUPT MASK. 



ADDRESSING MODE ASSEMBLY CODE 

OP CODE 

NO. OF BYTE? 

INHERENT SEI 

OF 

1 


SEV - SET TWO'S COMPLEMENT OVERFLOW BIT. 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTE? 

INHERENT 

SEV 

OB 

1 















STA 


STORE ACCUMULATOR. 


#13. 0. 0 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A DIRECT 

STA 

A 

OPER 

97 

2 

A EXTENDED 

STA 

A 

OPER 

B7 

3 

A INDEXED 

STA 

A 

OPER,X 

A7 

2 

B DIRECT 

STA 

B 

OPER 

D7 

2 

B EXTENDED 

STA 

B 

OPER 

F7 

3 

B INDEXED 

STA 

B 

OPER, X 

E7 

2 


STS - STORE STACK 

POINTER. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

DIRECT 

STS 

OPER 

9F 

7 

EXTENDED 

STS 

OPER 

BF 

3 

INDEXED 

STS 

OPER, X 

AF 

2 


STX - STORE INDEX 

REGISTER. 




ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

DIRECT 

STX 

OPER 

DF 

2 

EXTENDED 

STX 

OPER 

FF 

3 

INDEXED 

STX 

OPER, X 

EF 

2 


SUB - SUBTRACT. 

ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A IMMEDIATE 

SUB A 

#OPER 

80 


A DIRECT 

SUB A 

OPER 

90 

2 

A EXTENDED 

SUB A 

OPER 

BO 

3 

A INDEXED 

SUB A 

OPER, X 

AO 

2 

B IMMEDIATE 

SUB B 

#OPER 

CO 

*7 

B DIRECT 

SUB B 

OPER 

DO 

2 

B EXTENDED 

SUB B 

OPER 

FO 

3 

B INDEXED 

SUB B 

OPER, X 

EO 

2 










SWI 


SOFTWARE INTERRUPT. 


#13. O. 0 


ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. OF BYTE 

INHERENT 

SWI 

3F 

1 


TAB - TRANSFER FROM 

ACCUMULATOR 

A TO 

ACCUMULATOR B. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE 

INHERENT 

TAB 


16 

1 


TAP - TRANSFER FROM ACC A TO PROCESSOR CONDITION CODES REO. 


ADDRESSING MODE ASSEMBLY CODE OP CODE NO. OF BYTE 

INHERENT ' TAP 06 1 


TBA ~ TRANSFER FROM 

ACCUMULATOR 

B TO 

ACCUMULATOR A. 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTE 

INHERENT 

TBA 


17 

1 


TPA - TRANSFER FROM 

PROCESSOR CONDITION 

CODES REG. 

TO ACC 

A. 

ADDRESSING MODE 

ASSEMBLY CODE 

OP CODE 

NO. 

OF BYTE 

INHERENT 

TPA 

07 

1 



















TST - TEST. 


#13. 0. 0 


I 


ADDRESSING MODE 

ASSEMBLY 

CODE 

OP CODE 

NO. OF BYTES 

A 

TST 

A 

4D 

1 

B 

TST 

B 

5D 

1 

EXTENDED 

TST 

OPER 

7D 

3 

INDEXED 

TST 

OPER» X 

6D 

2 


TSX - TRANSFER FROM STACK POINTER TO 

INDEX REGISTER. 


ADDRESSING MODE ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT TSX 

30 

1 


TXS - TRANSFER FROM 

INDEX REGISTER TO STACK POINTER. 


ADDRESSING MODE 

ASSEMBLY CODE OP CODE 

NO. OF BYTES 

INHERENT 

TXS 35 

1 


WAI - WAIT 

FOR INTERRUPT. 



ADDRESSING 

MODE ASSEMBLY CODE 

OP CODE 

NO. OF BYTES 

INHERENT 

WAI 

3E 

1 


( 












APPENDIX A - RUN-TIME OPTIONS. 


#14. 0. 0 




/B 

/E 

/H 

/.J 

/K 

/L 

/N 

/O 

/P 

/s 

/T 

/W 

/O TO /9 


- OUTPUT BINARY FILE IN BNPF FORMAT. 

- INHIBIT ERROR MESSAGES TO CONSOLE. 

- INHIBIT HEADINGS AND PAGINATION. 

-LIST UNASSEMBLED STATEMENTS AND CONDITIONAL 
ASSEMBLY PSEUDO-OPS. 

- EXPAND SYMBOL TABLE STORAGE INTO ADDITIONAL 
CORE. 

- OUTPUT LEADER (NULLS) IN BINARY FILE FOR EACH 
. ORG STATEMENT. 

- LIST ONLY THE SYMBOL TABLE. 

- OUTPUT LISTING IN OCTAL FORMAT INSTEAD OF IN 
HEXADECIMAL. 

- INCLUDE NORMALLY UNLISTED PSEUDO-OPS IN THE 
LISTING. 

- OMIT THE SYMBOL TABLE FROM THE LISTING. 

- REPLACE THE FORM/FEED WITH 3 CR/LF'S. 

- INHIBIT WARNING MESSAGES. 

- USER FLAGS, USED WITH THE ? OPERATOR. 




APPENDIX B - INDICATOR SET. 

#**#*****#*#*****####«•#'** 

* MULTIPLICATION. 

/ DIVISION. 

& BOOLEAN AND. 

! INCLUSIVE OR. 

+ ADDITION. 

SUBTRACTION. 

•-C COMPLEMENT INDICATOR, (UPARROW B). 

-'B BINARY RADIX INDICATOR, (UPARROW B). 

-D DECIMAL RADIX INDICATOR, (UPARROW D). 

•••H HEXADECIMAL RADIX INDICATOR, (UPARROW H). 

•"■0 OCTAL RADIX INDICATOR, (UPARROW 0). 

•-L LEAST SIGNIFICANT BYTE ACCESS OPERATOR, 

(UPARROW L). 

••'•M MOST SIGNIFICANT BYTE ACCESS OPERATOR, 

(UPARROW M). 

; COMMENT INDICATOR. 

" OR •' ASCII CHARACTER INDICATOR. 

? USER FLAG OPERATOR. 

CURRENT LOCATION COUNTER, (PERIOD). 





APPENDIX C - PSEUDO-OPS. 
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. ADDR 
. BIN 
. BYTE 
. DBYTE 
. DECM 
. DINST 
. END 
. ENDC 
. EQU 
. HEX 
. IFDEF 
. IFNDEF 
. IFNZRO 
. IFZERO 
. LIST 
. OCT 
. ORG 
. PAGE 
. SET 
. TITLE 
. ZERO 


DOUBLE BYTE DATA STORAGE, REVERSED FORMAT. 

CHANGES DEFAULT RADIX TO BINARY. 

SINGLE BYTE DATA STORAGE. 

DOUBLE BYTE DATA STORAGE. 

CHANGES DEFAULT RADIX TO DECIMAL. 

RENAMES A MICROPROCESOR INSTRUCTION. 

PROGRAM TERMINATOR. 

ENDS CONDITIONAL ASSEMBLY. 

ASSIGNS A PERMANENT VALUE TO A SYMBOL. 

CHANGES DEFAULT RADIX TO HEXADECIMAL. 

INCLUDE CODE TO . ENDC IF SYMBOL IS DEFINED. 

INDLUDE CODE TO . ENDC IF SYMBOL IS NOT DEFINED. 

INCLUDE CODE TO . ENDC IF OPERAND DOES NOT EQUAL 0. 

INCLUDE CODE TO . ENDC IF OPERAND EQUALS 0. 

PROVIDES SELECTIVE LISTINGS. 

CHANGES DEFAULT RADIX TO OCTAL. 

REASSIGNS THE CURRENT LOCATION COUNTER. 

BEGINS NEW PAGE IN LISTING. 

ASSIGNS A TEMPORARY VALUE TO A SYMBOL. 

SPECIFIES HEADING. 

ZEROS A SPECIFED NUMBER OF BYTES. 





APPENDIX D 


ERROR MESSAGES 
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E: BN 
E: BR 
E: BY 
E . DF 
E: DR 
E: IL 
E: 10 
E: LO 
E: LS 
E: LT 
E: ML 
E: MO 
E: OA 
E: OC 
E: OE 
E: OM 
E: OS 
E: PE 
E: PS 
E: RE 
E: ST 
E: TL 
E: US 
E: WE 


- BAD NESTING OF BRACKETS. 

- BRANCH IS OUT OF RANGE. 

- BYTE VALUE REQUIRED. 

- OUTPUT FILE DEVICE FULL. (FATAL) 

- DIGIT OUTSIDE OF RADIX. 

- ILLEGAL LABEL FIELD. 

- ILLEGAL OPERAND VALUE. 

- LINE INPUT OVERFLOW. 

- LOCAL SYMBOL SYNTAX ERROR. 

- LOCAL SYMBOL TABLE OVERFLOW. (FATAL) 

- MULTIPLE LABEL DEFINITION. 

- MISSING OR ILLEGAL MNEMONIC IN OPERATOR FIELD. 

- ILLEGAL OPERAND ADDRESSING MODE. 

- OPERAND TOO COMPLEX. 

- OPEN ERROR IN OUTPUT FILE. (FATAL) 

- OPERAND MISSING. 

- OPERAND SYNTAX ERROR. 

- PHASE ERROR* ADDRESS CONFLICT. (FATAL) 

- ILLEGAL PERMANENT SYMBOL USAGE IN OPERAND. 

- INPUT FILE READ ERROR. (FATAL) 

- SYMBOL TABLE OVERFLOW. (FATAL) 

- LABEL DEFINED TOO LATE. 

- UNDEFINED SYMBOL. 

- OUTPUT FILE WRITE ERROR. (FATAL) 


W: EF 
W: UC 

W: FZ 


- NO . END STATEMENT IN LAST FILE. 

- UNINHIBITED CONDITIONAL ASSEMBLY IN EFFECT 
AT ASSEMBLY END. 

- FORWARD REFERENCE TO ZERO PAGE. 







